JSON Payload

As Simility’s software accepts data feeds only in the form of JSON format, you can construct the JSON payload using the following parameters to send data feeds from your back-end servers.

Parameters
Name Type Description
entity String Name of the table in which the data to be stored.
id String A unique ID that identifies a record in the entity.
fields key-value The fields parameter is a map of key-value pairs. The key-value pairs are the actual data feeds (schema) that you are suppose to send to Simility’s software for fraud detection. Work with the data analyst assigned to your business to discuss and freeze schema before you start sending the data feeds to Simility software.
The Simility software accepts all basic data types (such as String, Numeric, Date) and also accepts nested data, including maps and arrays, to support complex data structure.
Individual key-value data within the fields parameter can change for every POST; that is, sending a subset of fields or any additional field per call and the schema is dynamically handled at Simility’s back end.
For the update endpoint, the existing records will be updated or merged based on the unique key (id) of the payload.

Example

//Ad Table
[{
	"entity": "ad",
	"id": "CA360497",
	"fields": {
		"language": "en-US",
		"referral_channel": "www.google.com",
		"creation_time": "2015-05-23 13:35:00",  //please use UTC  timezone.
		"ip_address": "204.23.100.11",  //from DeviceRecon, but you can provide it too.
		"session_id": "ES45D54ER82GF5D2DF5DFG1DF5DFG51DF",
		"device_id": "87YU98YUHJK", //from DeviceRecon
		"device_user_agent": "CorpInc/2.1.8 (build: 140111135; samsung SM-N910V LMY47X; Android 5.1.1; en_US)",  //from DeviceRecon
		"status": "ACTIVE",
		"market_region": "US",
		"user_id": "MCBUGGY1978",  //user who created the ad
		"user_first_name": "John",
		"user_last_name": "Doe",
		"user_email": "john.doe@gmail.com",
		"user_phone": "6502398673",
		"title": "New motorcycle battery",
		"description": "Selling brand new motorcycle battery $70 obo",
		"image_phash": "723443A87934IURJE",
		"image_url": "www.buy-my-stuff.com/CA360497/image.html",
		"category_level1": "Electronics",
		"category_level2": "General",
		"category_level3": "Battery",
		"listing_type": "Premium",
		"item_condition": "new",
		"location": "Palo Alto",
		"currency" : "USD",
		"price": 70,
		"price_usd": 70
		"custom_field_1": "xyz", //any additional field you would like to send. Please let us know the final field name.
		"custom_field_2": "xyz", //any additional field you would like to send. Please let us know the final field name.
		"custom_field_3": "xyz", //any additional field you would like to send. Please let us know the final field name.
		"custom_field_4": "xyz", //any additional field you would like to send. Please let us know the final field name.
		"custom_field_5": "xyz" //any additional field you would like to send. Please let us know the final field name.
	}
}]