Antel Merchandiser App API

<back to all web services

CheckPrincipals

Requires Authentication
The following routes are available for this service:
POST/principal/check
CheckPrincipals Parameters:
NameParameterData TypeRequiredDescription
PrincipalsbodyList<PrincipalAppSync>Yes
ApiServiceRequest Parameters:
NameParameterData TypeRequiredDescription
ApiKeyformstringYesThe API Key required for authentication
LatitudeformdoubleNoLatitude of the user making this request
LongitudeformdoubleNoLongitude of the user making this request
PrincipalAppSync Parameters:
NameParameterData TypeRequiredDescription
PrincipalIdformintNo
LastUpdatedformstringYes
CheckPrincipalsResponse Parameters:
NameParameterData TypeRequiredDescription
PrincipalsToUpdateformList<int>Yes
PrincipalAppSyncDataformList<PrincipalAppSync>Yes
AuthRulesformList<PrincipalAuthRuleData>Yes
ApiServiceResponse Parameters:
NameParameterData TypeRequiredDescription
DescriptionformstringYesInformation about the response.
HeadingformstringYesHeading or summary of the response.
WasSuccessfulformbooleanYesDid the intended operation for this response complete successfully?
ResponseStatusformResponseStatusYes
PrincipalAuthRuleData Parameters:
NameParameterData TypeRequiredDescription
PrincipalIdformintNo
ValueAuthRulesformList<AuthRuleData>Yes
UnitAuthRulesformList<AuthRuleData>Yes
AuthRuleData Parameters:
NameParameterData TypeRequiredDescription
FromValueformdoubleNo
ToValueformdoubleNo
AllowformboolNo
AuthRequiredformboolNo
RegionformstringYes
ChannelformstringYes
UnitOfMeasureformUnitOfMeasureDataYes
UnitOfMeasureData Parameters:
NameParameterData TypeRequiredDescription
IdformintNo
NameformstringYes

To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv

HTTP + JSV

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /principal/check HTTP/1.1 
Host: returnit-api-dev.happen.zone 
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length

{
	Principals: 
	[
		{
			PrincipalId: 0,
			LastUpdated: String
		}
	],
	ApiKey: String,
	Latitude: 0,
	Longitude: 0
}
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	PrincipalsToUpdate: 
	[
		0
	],
	PrincipalAppSyncData: 
	[
		{
			PrincipalId: 0,
			LastUpdated: String
		}
	],
	AuthRules: 
	[
		{
			PrincipalId: 0,
			ValueAuthRules: 
			[
				{
					
				}
			],
			UnitAuthRules: 
			[
				{
					
				}
			]
		}
	],
	Description: String,
	Heading: String,
	WasSuccessful: False,
	ResponseStatus: 
	{
		ErrorCode: String,
		Message: String,
		StackTrace: String,
		Errors: 
		[
			{
				ErrorCode: String,
				FieldName: String,
				Message: String,
				Meta: 
				{
					String: String
				}
			}
		],
		Meta: 
		{
			String: String
		}
	}
}