# PubDia

> Agendador de posts para redes sociais — para humanos e agentes de IA.

## Comece aqui

- API REST: https://pubdia.com/api/v1 (documentação OpenAPI 3.1: /api/v1/openapi.json)
- Servidor MCP: https://pubdia.com/api/mcp (Streamable HTTP; OAuth 2.1 ou chave de API)
- Autenticação: chave de API "Authorization: Bearer pd_…" com escopos
  (posts:read, posts:write, media:write, accounts:read). Gere em Integrações.
- Erros: { "erro": { "codigo", "mensagem", "fix?" } } — o campo fix diz como corrigir.
- Criações aceitam header Idempotency-Key (repetir não duplica).
- Horários em ISO 8601 com fuso; a resposta repete o horário.
- Rate limit por plano informado em X-RateLimit-Remaining.

## Fluxo típico de um agente

1. GET /api/v1/platforms/{rede}/rules — gere conteúdo válido (limites e formatos).
2. POST /api/v1/media — envie a mídia e leia os avisos de compatibilidade.
3. POST /api/v1/posts/validate — dry-run antes de agendar.
4. POST /api/v1/posts — crie o rascunho/agendamento (agendado_para em ISO 8601).
   Para um mês inteiro, use POST /api/v1/posts/bulk (até 100 posts).
5. GET /api/v1/posts/{id} — status, link publicado e motivo de falha.
6. GET /api/v1/usage — consumo do plano (contas, posts, cota do X, chamadas).

## SDKs

SDKs TypeScript e Python são gerados a partir do OpenAPI:
  npx openapi-typescript https://pubdia.com/api/v1/openapi.json -o api.d.ts
  openapi-python-client generate --url https://pubdia.com/api/v1/openapi.json