PRÉ-REQUISITO: URL DE RESULTADO DA CONSULTA PARA WEBHOOKS
Amzpecty requer URL de retorno de chamada para notificações push de API de dados do Webhook. Eles informam ao seu aplicativo os resultados da consulta (incluindo carga útil de dados). A URL de retorno de chamada deve ser acessível globalmente, usando o protocolo https POST e com um certificado SSL válido. Amzpecty pode não conseguir enviar webhooks para certificados SSL autoassinados.
Em Java, você pode usar HttpServlet com o método doPost para receber a carga de dados Amzpecty. Em outras linguagens de programação, você pode implementar a mesma solução equivalente. Você pode implementar seu ouvinte de webhook usando qualquer linguagem de programação que suporte o protocolo HTTPS Post.
Certifique-se de que seu URL de retorno de chamada esteja pronto e inserido no Painel Amzpecty https://api.amzpecty.com/preferences. Depois que o Amzpecty terminar de pesquisar os dados, o Amzpecty postará em HTTPS neste URL os dados do resultado formatados em JSON. Quando o cabeçalho AMZPECTY_CALLBACK_URL for adicionado à chamada de solicitação, ele terá precedência sobre as configurações de URL de retorno de chamada de preferências.
Um cabeçalho http denominado AMZPECTY-API-SECRET-KEY será incluído na postagem https para o ouvinte do webhook validar a origem da solicitação.
ETAPAS E PROCEDIMENTO
- Faça uma chamada Adicionar [ Adicionar Asin/ISBN à fila de consulta de instantâneo Asin ] ou [Adicionar Asin Pai à Fila de Consulta de Variações do Produto] ou [ Combine o ID do produto com a fila de consulta ASIN ] etc. para colocar sua solicitação na fila de consulta.
- O servidor API Amzpecty fará uma chamada para seu URL de retorno de chamada para enviar os resultados assim que a pesquisa for concluída.
- Seu aplicativo pode usar a resposta de chamada rid from Add para corresponder o retorno de chamada à sua solicitação original.
Observação: Para chamadas não relacionadas a variantes, certifique-se de que o ASIN não seja um ASIN pai ou um ASIN descontinuado.
Você não precisa fazer a consulta Get opcional, a menos que tenha decorrido um tempo considerável e nenhum retorno de chamada seja recebido. Evite fazer chamadas Add sucessivas do mesmo ASIN.
SUBSTITUIÇÃO DO AGENTE DO USUÁRIO
Os clientes podem substituir o cabeçalho User-Agent padrão para um cabeçalho específico especificando a chave e o valor AMZPECTY-USER-AGENT durante uma chamada Add.
A API Amzpecty definirá o valor do User-Agent durante as chamadas de post-back.
CODIFICAÇÃO
- A codificação de dados de solicitação/resposta deve ser UTF-8
PONTO FINAL
Entre em contato com o suporte para URLs personalizados para servidores exclusivos ou personalizados.
SEGURANÇA
- Todas as conexões de troca de dados entre Amzpecty e pares devem ser através de HTTPS (SSL/TLS) com um certificado SSL válido
- Amzpecty emitirá uma chave secreta para autenticação de solicitação (o nome do parâmetro é secretKey) – A chave secreta pode ser encontrada na página Preferências > API Amzpect > Sua chave secreta da API.
TEMPO DE RESPOSTA À CONSULTA
Embora façamos o possível para processar todas as solicitações de consulta em tempo hábil, não garantimos a pontualidade do retorno de chamada do resultado. Considere atrasos de resposta em sua implementação.
SOLICITAR ACELERAÇÃO
Certifique-se de que suas solicitações sejam definidas em intervalos de pelo menos 1 a 2 segundos para evitar chamadas de API rejeitadas. Temos verificações para evitar solicitações excessivas. Entre em contato com o suporte para exceções em servidores personalizados.
DEDUÇÕES DE CRÉDITO
O crédito só é deduzido após a recuperação bem-sucedida dos dados. Receber chamadas como Get by RID não deduzirá nenhum crédito.
