Apresentando: Webhooks para clientes para PhotoRobot Cloud

Webhooks de clientes para PhotoRobot Cloud

Seus desenvolvedores e equipes de TI agora podem conectar o PhotoRobot Cloud ao seu DAM, PIM, ERP ou automação personalizada com webhooks de saída assinados. Webhooks de clientes no PhotoRobot Cloud oferecem entrega de dados confiável e orientada a eventos – garantindo conectividade total entre seu estúdio e os sistemas.

‍

‍

‍

Feche o Loop entre seu Estúdio e os Sistemas

Garanta que seus sistemas posteriores saibam quando o status de um item muda ou ocorre um evento de disponibilidade de hospedagem. PhotoRobot Cloud Customer Webhooks entregam cada evento aos seus endpoints para que as integrações permaneçam orientadas por eventos – e não por polling.

Os eventos ao vivo são:

• item.status.changed – Mudança de status de captura realizada em um item.
• item.status.bulk_changed — um evento após uma mudança de status no Cloud bulk.
• hosting.item.availability.changed — mídia hospedada passou a ser baixada ou indisponível.
• webhook.subscription.test — Apenas enviar teste.

‍

‍

‍

Entrega Confiável e Orientada a Eventos

Webhooks para clientes no PhotoRobot Cloud incluem recursos para:

• Assinaturas de webhooks de saída gerenciadas junto com suas integrações com desenvolvedores.
• Entrega HTTP assinada para que os destinatários possam verificar a autenticidade.
• "Enviar teste" e filtros para confirmar a assinatura e verificação de assinatura do webhook.
• Registro de entrega para inspecionar o payload, status HTTP e tentativas.
• Interface do desenvolvedor sob Webhooks — webhooks e entregas estão ao lado das chaves da API.

‍

‍

‍

Falando Sua Linguagem para Integrações de Produção

Webhooks de clientes são o elo perdido entre captura robotizada e sistemas de registro da empresa. O webhook é um sinal com assinatura, transportando apenas pequenas cargas úteis de propósito. Após 2xx, a integração puxa o item atual do REST v2 (pull.itemUrl / pull.deltaUrl). Webhooks podem notificar um publisher ou, após a consulta, facilitar sua equipe no início de uma purga de CDN ou atualização de uma listagem no marketplace. PhotoRobot Cloud agora fala sua linguagem para integrações de produção.

‍

‍

‍

Um sinal, depois um puxão

As cargas úteis permanecem pequenas de propósito. Cada carga útil nomeia o evento, a organização e (quando relevante) o item, além de pull.itemUrl e pull.deltaUrl. Cargas úteis não carregam binários de imagem, árvores completas de pastas ou um registro completo do produto.

O padrão que os desenvolvedores devem implementar é:

1. Receba o POST e verifique a assinatura X-PhotoRobot contra o corpo bruto.
2. Devolva o 2xx rapidamente — faça a importação DAM ou atualização do marketplace no seu próprio trabalhador.
3. Deduplicar por ID de evento. A entrega é pelo menos uma vez.
4. Obtenha o estado atual do hospedagem REST v2 usando os pull URLs.

Essa divisão é o que torna a integração confiável. PhotoRobot não espera o seu trabalho de catálogo terminar, e seu sistema nunca trata uma notificação como catálogo.

‍

‍

‍

Exemplos Comuns de Webhooks de Clientes em Uso

Os casos de uso mais comuns para Webhooks de Cliente no ecossistema PhotoRobot incluem:

• PIM ou DAM refresh. Assine hosting.item.availability.changed. Quando a mídia hospedada ficar disponível para download, extraia itemUrl e atualize o produto — spins, imagens e metadados em uma única passagem.
• Listagem no Marketplace. Filtre eventos de hospedagem para "Ficou para download." Publique ou atualize o anúncio somente depois que o PhotoRobot puder realmente exibir as imagens.
• Visibilidade da placa de produção. Assine o item.status.changed quando seu ERP ou placa de controle de qualidade precisar saber que um item foi movido para EDITADO, APROVADO ou PUBLICADO — mesmo antes do hospedagem estar pronto.
• Atualizações em massa da campanha. Após uma grande mudança de status na Cloud, um evento item.status.bulk_changed chega com um deltaUrl. Atualize o conjunto afetado em vez de esperar milhares de webhooks por item.
• Invalidação de cache ou CDN. Quando hospedar muda para disponível ou indisponível, limpe ou aqueça os caminhos que sua loja já conhece. O webhook é o gatilho; A API de hospedagem é a fonte das novas URLs.

‍

‍

‍

Como Configurar Webhooks do Seu Cliente

Para configurar Webhooks de Cliente para PhotoRobot Cloud, abra sua Conta PhotoRobot no modo Desenvolvedores e use Webhooks para criar uma assinatura de webhook. Depois, aponte a assinatura para o endpoint de staging para verificar a primeira entrega.

‍

‍

1. Faça login na PhotoRobot Conta e abra o Developers → Webhooks.
2. Crie um webhook. Cole seu endpoint HTTPS, dê um nome interno e escolha os eventos que você precisa.
3. Copie o segredo de assinatura quando ele aparecer — ele é mostrado uma vez até você girá-lo.
4. Clique em enviar test. Confirme que webhook.subscription.test chega e a assinatura verifica.
5. Abra o log de entrega para inspecionar o payload, o status HTTP e as tentativas.
6. Aponte a primeira assinatura para um endpoint de staging.

‍

‍

Para mais informações técnicas, incluindo exemplos de contratos de desenvolvedores e assinaturas, consulte o PhotoRobot Developer Portal – Webhooks.

‍

‍