# Referência da API

> As 79 rotas da API do Praeko em 18 recursos: parâmetros, corpo, exemplos em 10 linguagens, respostas e erros de cada uma.

Fonte: https://praeko.app/docs/api

Todas as 79 rotas do contrato v1, geradas do mesmo arquivo do [openapi.json](https://praeko.app/openapi.json). Cada página traz o escopo mínimo da chave, os parâmetros, o corpo com um exemplo pronto, o código em 10 linguagens, a resposta de exemplo e os erros.

> **Em toda requisição** URL base `https://praeko.app`. Cabeçalhos `Authorization: Bearer praeko_…` e `X-Praeko-Contract: en`. Veja [autenticação e escopos](https://praeko.app/docs/auth).

## Recursos

| Recurso | Rotas | O que tem |
|---|---|---|
| [Saúde](https://praeko.app/docs/api/health) | 2 | Saúde do serviço, Saúde do serviço (caminho versionado) |
| [Conexões](https://praeko.app/docs/api/connections) | 4 | Retorno do OAuth, Iniciar conexão de rede, Desconectar rede… |
| [Mídia](https://praeko.app/docs/api/media) | 11 | Mídia pública por token, Mídia pública por token, Criar mídia… |
| [Canais](https://praeko.app/docs/api/channels) | 8 | Listar canais, Canal padrão da rede, Remover canal… |
| [TikTok](https://praeko.app/docs/api/tiktok) | 1 | Criador no TikTok |
| [Posts](https://praeko.app/docs/api/posts) | 9 | Criar post, Adotar post já publicado, Listar posts… |
| [Calendário](https://praeko.app/docs/api/calendar) | 1 | Calendário |
| [Insights](https://praeko.app/docs/api/insights) | 4 | Métricas, Retenção, impressões e CTR, Retenção de um post… |
| [Conteúdo](https://praeko.app/docs/api/content) | 1 | Conteúdo publicado |
| [YouTube](https://praeko.app/docs/api/youtube) | 7 | Vídeos do YouTube, Ver vídeo do YouTube, Editar vídeo do YouTube… |
| [Instagram](https://praeko.app/docs/api/instagram) | 6 | Mídias do Instagram, Comentários do Instagram, Responder comentário do Instagram… |
| [Comentários](https://praeko.app/docs/api/comments) | 2 | Comentários de todas as redes, Menções |
| [Chaves de API](https://praeko.app/docs/api/api-keys) | 3 | Listar chaves de API, Criar chave de API, Revogar chave de API |
| [Uso e log](https://praeko.app/docs/api/usage-and-log) | 2 | Resumo de uso, Log de requisições |
| [Preferências](https://praeko.app/docs/api/preferences) | 2 | Ver preferências, Salvar preferências |
| [Avisos](https://praeko.app/docs/api/notifications) | 2 | Listar avisos do painel, Marcar avisos como lidos |
| [Webhooks](https://praeko.app/docs/api/webhooks) | 9 | Listar webhooks, Criar webhook, Ver webhook… |
| [Ideias](https://praeko.app/docs/api/ideas) | 5 | Listar ideias, Criar ideia, Importar ideias… |

## Para o seu gerador de cliente

O arquivo [openapi.json](https://praeko.app/openapi.json) (OpenAPI 3.1) traz o mesmo contrato. Na tela de documentação do painel (depois de entrar) também dá para baixar a coleção do Postman.