REQUISITO PREVIO: URL DE DEVOLUCIÓN DE LLAMADA DEL RESULTADO DE LA CONSULTA PARA WEBHOOKS
Amzpecty requiere una URL de devolución de llamada para las notificaciones API de envío de datos de Webhook. Le informan a su aplicación los resultados de la consulta (incluida la carga útil de datos). La URL de devolución de llamada debe ser accesible globalmente, mediante el protocolo https POST y con un certificado SSL válido. Es posible que Amzpecty no pueda enviar correctamente webhooks a certificados SSL autofirmados.
En Java, puede utilizar HttpServlet con el método doPost para recibir la carga útil de datos de Amzpecty. En otros lenguajes de programación, puede implementar la misma solución equivalente. Puede implementar su escucha de webhook utilizando cualquier lenguaje de programación que admita el protocolo HTTPS Post.
Asegúrese de que su URL de devolución de llamada esté lista e ingresada en el Panel de control de Amzpecty https://api.amzpecty.com/preferences. Una vez que Amzpecty haya terminado de buscar datos, Amzpecty publicará mediante HTTPS en esta URL los datos de resultados en formato JSON. Cuando se agrega el encabezado AMZPECTY_CALLBACK_URL a la llamada de solicitud, tendrá prioridad sobre la configuración de URL de devolución de llamada de Preferencias.
Se incluirá un encabezado http denominado AMZPECTY-API-SECRET-KEY en la publicación https para que el oyente del webhook valide el origen de la solicitud.
PASOS Y PROCEDIMIENTO
- Realizar una llamada adicional [ Agregue Asin/ISBN a la cola de consultas de instantáneas de Asin ] o [ Agregar ASIN principal a la cola de consultas de variaciones del producto ] o [ Hacer coincidir el ID del producto con la cola de consultas ASIN ] etc. para colocar su solicitud en la cola de consultas.
- El servidor API de Amzpecty realizará una llamada a su URL de devolución de llamada para enviar los resultados tan pronto como se complete la búsqueda.
- Su aplicación puede utilizar la eliminación de Agregar respuesta de llamada para hacer coincidir la devolución de llamada con su solicitud original.
Nota: Para llamadas relacionadas sin variantes, asegúrese de que el ASIN no sea un ASIN principal ni un ASIN descontinuado.
No es necesario realizar la consulta Obtener opcional a menos que haya transcurrido un tiempo considerable y no se reciba ninguna devolución de llamada. Absténgase de realizar llamadas Add sucesivas del mismo ASIN.
ANULACIÓN DEL AGENTE DE USUARIO
Los clientes pueden anular el encabezado User-Agent predeterminado para un encabezado específico especificando la clave y el valor AMZPECTY-USER-AGENT durante una llamada Agregar.
La API de Amzpecty establecerá el valor del Agente de usuario durante las llamadas de devolución.
CODIFICACION
- La codificación de datos de solicitud/respuesta debe ser UTF-8
PUNTO FINAL
Póngase en contacto con el soporte técnico para obtener URL personalizadas para servidores exclusivos o personalizados.
SEGURIDAD
- Todas las conexiones de intercambio de datos entre Amzpecty y sus pares deben realizarse a través de HTTPS (SSL/TLS) con un certificado SSL válido.
- Amzpecty emitirá una clave secreta para la solicitud de autenticación (el nombre del parámetro es secretKey). La clave secreta se puede encontrar en Página de preferencias > Amzpect API > Su clave secreta de API.
TIEMPO DE RESPUESTA A LA CONSULTA
Si bien hacemos todo lo posible para procesar todas las solicitudes de consulta de manera oportuna, No garantizamos la puntualidad de la devolución de llamada del resultado.. Considere los retrasos en la respuesta en su implementación.
SOLICITAR ACELERADOR
Asegúrese de que sus solicitudes se establezcan en intervalos de al menos 1 a 2 segundos para evitar llamadas API rechazadas. Contamos con controles para evitar solicitudes de ráfagas excesivas. Comuníquese con el soporte para excepciones en servidores personalizados.
DEDUCCIONES DE CRÉDITO
El crédito solo se deduce tras la recuperación exitosa de los datos. Recibir llamadas como Get by RID no deducirá ningún crédito.
