# Postmatic

> API de publicação e agendamento no Instagram: uma chave, um contrato, contas conectadas por OAuth.

## Documentação

- [Comece aqui](https://uat.postmatic.dev/pt/docs): Do primeiro acesso ao post publicado no Instagram em cinco chamadas. Base URL, autenticação e o ciclo completo de uma publicação.
- [Autenticação](https://uat.postmatic.dev/pt/docs/authentication): Chave de API para integrações, sessão do painel para o navegador. Como cada modo funciona, os limites de requisição e o envelope de erro que vale para toda a API.
- [Contas e profiles](https://uat.postmatic.dev/pt/docs/accounts): Conectar contas do Instagram por OAuth, agrupar por cliente com profiles, acompanhar a saúde de cada conexão e desconectar.
- [Publicações](https://uat.postmatic.dev/pt/docs/posts): Criar um post agora ou agendado, entender cada status, acompanhar até a conclusão, reagendar e cancelar. Idempotência e novas tentativas automáticas.
- [Mídia](https://uat.postmatic.dev/pt/docs/media): Duas formas de anexar imagens a um post, por URL pública ou upload direto, e os limites de formato, tamanho e proporção que a Postmatic valida antes de publicar.
- [Webhooks](https://uat.postmatic.dev/pt/docs/webhooks): Receba um POST assinado quando um post é agendado ou termina, verifique a assinatura, trate as novas tentativas e consulte o histórico de entregas.
- [Métricas e comentários](https://uat.postmatic.dev/pt/docs/engagement): Métricas de post e de conta direto da Meta, e gestão de comentários dos posts publicados. Exige permissões extras na conta conectada.
- [Mensagens diretas](https://uat.postmatic.dev/pt/docs/messages): Liste as conversas de uma conta, leia uma conversa e responda dentro da janela de 24 horas da Meta.
- [Erros](https://uat.postmatic.dev/pt/docs/errors): Todos os códigos de erro da API, com o status HTTP, a causa e o que fazer. Erros da Meta nunca chegam crus; cada um vira um código estável daqui.
- [Limites e convenções](https://uat.postmatic.dev/pt/docs/limits): Limites de requisição e de conteúdo, paginação, datas e fusos, ids, versionamento e as convenções que valem em todas as rotas.
- [O que ainda não existe](https://uat.postmatic.dev/pt/docs/roadmap): A lista honesta do que a API não faz hoje, com a alternativa enquanto não chega e a ordem em que pretendemos entregar.
- [Referência da API](https://uat.postmatic.dev/pt/docs/reference): Spec OpenAPI gerado das rotas, referência interativa de todas as operações, e como importar o contrato no Postman, no Insomnia ou em um gerador de cliente.

## Referência

- [OpenAPI](https://api.uat.postmatic.dev/openapi.json): spec OpenAPI 3 gerado das rotas
- [Referência interativa](https://api.uat.postmatic.dev/docs): todas as rotas, parâmetros e respostas

## Em inglês

- [Documentation](https://uat.postmatic.dev/en/docs)