Feito para pessoas e agentes de IA
Cada página aqui é legível por humanos — guias por tarefa e conceitos — apoiada por um contrato OpenAPI completo. A mesma referência vem em um cookbook aberto que você clona no seu projeto em segundos.
Trabalhando com um agente de IA? Clone o cookbook
RecomendadoAponte seu agente para o PLAYBOOK.md — um guia passo a passo para a referência da API e exemplos prontos, para ele ler só o necessário em cada etapa.
Ver o cookbook no GitHubPrefere colar como contexto? Baixe a documentação completa em um único arquivo Markdown, ou pegue só a spec.
Todas as requisições à API exigem uma chave de API no header X-API-Key.
Crie uma chave na página API Keys do portal. A chave completa é exibida apenas uma vez — guarde-a com segurança. Chaves perdidas não podem ser recuperadas; revogue e crie uma nova.
curl https://fiwano.com/api/v1/channels \
-H "X-API-Key: YOUR_API_KEY"
Todas as chaves começam com mip_live_. As chaves são armazenadas como hash do nosso lado.
Toda resposta de erro usa o mesmo formato — um campo detail com uma descrição legível:
{ "detail": "Human-readable error description" }
Alguns erros de validação trazem, em vez disso, um objeto detail estruturado (por exemplo text_too_long ao enviar um texto longo demais); os formatos por endpoint estão na Referência da API.
| Código | Significado | O que fazer |
|---|---|---|
200 |
Sucesso | — |
201 |
Criado | — |
400 |
Requisição inválida | Verifique o campo detail |
401 |
Não autorizado | Verifique seu header X-API-Key |
402 |
Pagamento necessário | Período de teste encerrado ou assinatura inativa — veja Assinaturas e Cobrança |
404 |
Não encontrado | O recurso não existe ou pertence a outra conta |
429 |
Limite de taxa excedido | Reduza o ritmo e tente novamente após Retry-After — veja limites de taxa |
502 |
Erro da API da Meta | Falha no upstream. Verifique detail. Tentar novamente pode ajudar. |
503 |
Sobrecarregado temporariamente | Descarte de carga transitório. Tente novamente após Retry-After. |
Documentação da API Fiwano