Autenticação
Toda requisição à API FlowData leva uma chave no cabeçalho Authorization.
Chave bearer
Crie uma chave no dashboard em Chaves de API. Ela começa com fd_ e é mostrada apenas uma vez. Envie-a em toda requisição:
Authorization: Bearer fd_SUA_CHAVE
O que uma chave alcança
Uma chave FlowData alcança todas as áreas FlowData da equipe para a qual foi emitida, e nada mais. Você pode definir uma data de validade e um limite de gasto mensal.
Chaves antigas
Chaves FlowSuite (pk_..., at_...) continuam funcionando nas cinco áreas de dados, sem data de término, e respondem ali com o cabeçalho Deprecation. A API de mídia não as aceita e responde com HTTP 403, por isso precisa de uma chave FlowData. Recomendamos a troca também para as áreas de dados.
Respostas de erro
| HTTP | Significado |
|---|---|
| 401 | Chave ausente ou inválida |
| 402 | A conta não cobre a requisição (insufficient_quota) ou o limite de gasto foi atingido (spend_limit_exceeded) |
| 403 | A chave não pode usar esta área, ou a conta está suspensa (billing_suspended) |
| 429 | Requisições demais. Jobs de mídia também informam falta de saldo aqui (insufficient_quota, spend_limit_exceeded) |
Limites de taxa
Os endpoints de mídia permitem 600 requisições e 60 novos jobs por minuto e por chave. Ao exceder, a resposta é 429 com Retry-After.