Pular para o conteúdo

Mudanças da API

Toda mudança de formato, limite ou código de erro dos webhooks entra aqui, com a data, no mesmo trabalho em que muda a API.

Os webhooks de entrada estreiam.

  • Rotas públicas em /hooks/{id}/{token}: POST (formato detectado, ou forçado por /discord, /slack e /betterstack), GET, e PATCH e DELETE de /messages/{message_id}. Veja Criar no app e URL.
  • Quatro formatos: GGspeak, Discord, Slack e Better Stack. Veja Formatos.
  • Cartão que se atualiza com a key: a mesma chave atualiza o mesmo cartão por 24 horas, e um alerta que volta depois de resolvido abre uma mensagem nova. Veja Cartão e key.
  • Chamar um cargo só em mensagem nova com estado alert; o payload nunca marca ninguém. Veja Chamar um cargo.
  • ?wait=true devolve a mensagem criada com o id (200); sem ele, 204. Veja Mensagens.
  • Limites: 10 webhooks por comunidade, 5 envios a cada 2 segundos e 30 por minuto por webhook, 60 por minuto por canal, corpo de até 16 KB. Veja Limites.
  • Erros no formato {code, message, docs}, com uma seção para cada code em Erros: hook_not_found, message_not_found, hook_paused, payload_too_large, payload_unrecognized, payload_invalid, rate_limited e internal.
  • CORS liberado para https://developers.ggspeak.app, para a página Experimente.
  • Tela Integrações no app, nas configurações da comunidade: criar, pausar, gerar novo link, mandar um teste e ver as últimas 20 entregas.