Como começar
1
Consulte o OpenAPI
/_docs/openapi-public.json ou abra a referência.2
Faça uma chamada de teste
GET / (ping público).3
Integre no seu projeto
Use os exemplos abaixo (cURL/Fetch) e ajuste para os endpoints que você precisa.
Exemplo: cURL (Ping público)
curl -X GET https://api.flow.sophialabs.com.br/ \ -H "Accept: application/json"
Exemplo: Fetch (Node/Browser)
await fetch("https://api.flow.sophialabs.com.br/", {
headers: { Accept: "application/json" }
}).then(r => r.json());Autenticação & Ambientes
Tipos de acesso
- Público: rotas sob o esquema
openapi-public.json— em geral não exigem token. - Privado: rotas autenticadas via
Authorization: Bearer <token>(leads, disparos, etc.).
Exemplo de chamada autenticada (Fetch)
const token = "SEU_TOKEN_JWT_AQUI";
const res = await fetch("https://api.flow.sophialabs.com.br/leads", {
headers: { Authorization: `Bearer ${token}` }
});
const data = await res.json();Ambientes & CORS
Front:
cronosflow.sophialabs.com.brAPI:
api.flow.sophialabs.com.brCORS permitidos (backend):
https://api.flow.sophialabs.com.br
https://cronosflow.sophialabs.com.br
Erros comuns & limites
400
Requisição inválida
Parâmetros ausentes/formatos incorretos. Verifique o schema do endpoint.
401
Não autorizado
Token ausente/expirado. Envie Bearer token válido no header Authorization.
429
Limite atingido
Respeite a janela de cotas e utilize retry/backoff. Alguns recursos têm quotas por período.
Os detalhes de erros geralmente vêm em detail no JSON de resposta.
Recursos adicionais
OpenAPI no Front
JSON servido via rewrite do Next.
/_docs/openapi-public.json