Menu

Documentação

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
Envie a chave somente no cabeçalho, nunca na URL. URLs acabam em logs de servidores e proxies.

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

HTTPSignificado
401Chave ausente ou inválida
402A conta não cobre a requisição (insufficient_quota) ou o limite de gasto foi atingido (spend_limit_exceeded)
403A chave não pode usar esta área, ou a conta está suspensa (billing_suspended)
429Requisiçõ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.

Uma chave basta para começar.

Crie uma chave e chame a API. As informações do cliente são gratuitas; o restante é cobrado por solicitação bem-sucedida.

Criar chave de API Documentação

O FlowData é destinado exclusivamente a empresas e profissionais autônomos.