1. Home
  2. Amzpecty Documentation
  3. Amzpecty API Specifications
  4. System Diagram

System Diagram

Please refer to the above System Diagram.

PRE-REQUISITE: QUERY RESULT CALLBACK URL

Please make sure your Callback URL is ready and entered in the Preferences Page. After Amzpecty is done looking up data, Amzpecty will HTTPS Post to this URL the JSON formatted result data. When AMZPECTY_CALLBACK_URL header is added into the request call, it will take precedence over the Preferences Callback URL settings. The callback URL must be globally accessible, using HTTPS protocol, and with a valid SSL certificate.

STEPS AND PROCEDURE

  1. Make an Add call [ Add Asin/ISBN to Asin Snapshot Query Queue ] or [ Add Parent Asin to Product Variations Query Queue ] or [ Match Product Id to ASIN Query Queue ] etc. to put your request to the query queue.
  2. Amzpecty API server will make a call to your Callback URL to send the results as soon as the search is completed.
  3. Your application may use the rid from the Add call response to match the callback to your original request.

Note: For non-variant related calls, please ensure the ASIN is not a Parent ASIN or a discontinued ASIN.

You don’t need to make the optional Get query unless considerable time has elapsed, and no callback is received. Please refrain from making successive Add calls of the same ASIN.

USER AGENT OVERRIDE

Clients can override the default User-Agent header for a specific header by specifying AMZPECTY-USER-AGENT key and value during an Add call.

Amzpecty API will set the User-Agent value during post-back calls.

ENCODING

  • Request/Response data encoding should be UTF-8

ENDPOINT

https://api.amzpecty.com

Contact support for custom URLs for exclusive or custom servers.

SECURITY

  • All data exchange connections between Amzpecty and peers must be through HTTPS (SSL/TLS) with a valid SSL certificate
  • Amzpecty will issue a secret key for request authentication (parameter name is secretKey) – The secret key can be found on Preferences Page > Amzpect API > Your API Secret Key.

QUERY RESPONSE TIME

While we do our best to process all query requests in a timely manner, we do not guarantee the timeliness of the result callback. Please consider response delays in your implementation.

REQUEST THROTTLE

Please ensure your requests are set at least 1-2 seconds intervals to avoid rejected API calls. We have checks in place to avoid excessive burst requests. Please contact support for exceptions on custom servers.

CREDIT DEDUCTIONS

Credit is only deducted upon successful retrieval of data. Get calls like Get by RID will not deduct any credit.

Was this article helpful to you? Yes No

How can we help?