Common Request and Response Objects

API Request Object

The Request Object JSON structure.

NameTypeDescription
urlStringURL (Generic URI format ref: RFC).
textStringText Paragraph.

API Response Types

Unsuccessful Response Object

The unsuccessful response JSON structure.

NameTypeDescription
statusStringRequest Status (Reference: Status & Error Codes ).
errorCodeIntegerRequest error code (Reference: Status & Error Codes ).
messageStringError message.
licenseStringAmplifyReach License.

Example: Unsuccessful Response


{   "license": "By accessing AmplifyReach or using information generated by AmplifyReach API, you are agreeing to be bound by the AmplifyReach Terms of Use.",   "errorCode": 1003,   "message": "Authentication Failed - Unknown User",   "status": "fail"}

Pending Response Objects

The pending response JSON structure.

NameTypeDescription
statusStringRequest Status (Reference: Status & Error Codes )
uidStringPending Request ID
licenseStringAmplifyReach License.

Example: Pending Response

{  
    "uid": "0e438ffd7327a87749b5aaa4ec64d16d",  
    "license": "By accessing AmplifyReach or using information generated by AmplifyReach API, 
    you are agreeing to be bound by the AmplifyReach Terms of Use.",      "status": "pending"
}