Astorya Developers
Referência

Changelog

O que mudou na API de parceiros. Mudanças incompatíveis só acontecem numa nova versão (/partner/v2), com aviso prévio.

Nesta página
  1. v1 outubro de 2026
  2. Política de versões

v1 outubro de 2026

Primeira versão pública da API de parceiros.

  • Login único: POST /partner/v1/sessions com criação no primeiro acesso e launchUrl de 60 s e uso único.
  • Embed: parâmetros embed=1 e closable=1 e os eventos astorya:ready, astorya:session-expired, astorya:close e astorya:open-external.
  • Gestão de usuários: PUT, GET e DELETE em /partner/v1/users/{externalUserId}.
  • Catálogo: GET /partner/v1/catalog com paginação por cursor.
  • Relatórios: GET /partner/v1/usage?month=AAAA-MM.
  • Autenticação HTTP Basic com credenciais criadas no painel e limite de 120 requisições por minuto por credencial.

Política de versões

  • Sem aviso (compatível): novos endpoints, novos campos opcionais nas requisições, novos campos nas respostas, novos tipos de evento da ponte e novos valores de code. Seu código deve ignorar o que não conhece.
  • Com nova versão: remoção ou renomeação de campos, mudança de tipo ou de significado. A versão anterior continua funcionando durante um período de transição comunicado aos parceiros.