API da DevsNorte
Consulte eventos e projetos, ou submeta o seu, direto pelo terminal ou por um agente (Claude Code, Codex, Cursor) — sem precisar abrir o site.
Primeiro passo
Gere um token de API
Toda chamada autenticada usa um token pessoal, gerado em Chaves de API (requer login recente — "modo sudo"). Escolha um escopo:
-
read— qualquer endpointGET. -
read_write— além do acima,POST,PUT,PATCHeDELETE.
O token é exibido uma única vez na criação — guarde-o num cofre de segredos ou variável de ambiente, nunca em código versionado. Ele expira em até 90 dias e pode ser revogado a qualquer momento.
Na prática
Exemplos com curl
Listar projetos (sem token)
curl https://comunidade.devsnorte.com/api/v1/projetos
Confirmar seu token
curl https://comunidade.devsnorte.com/api/v1/me \
-H "Authorization: Bearer dsn_SEU_TOKEN"
Criar um projeto (rascunho, escopo read_write)
curl -X POST https://comunidade.devsnorte.com/api/v1/projects \
-H "Authorization: Bearer dsn_SEU_TOKEN" \
-H "Content-Type: application/json" \
-d '{"project": {"title": "Meu Projeto", "short_description": "...", "url": "https://..."}}'
Enviar esse rascunho para moderação
curl -X POST https://comunidade.devsnorte.com/api/v1/projects/ID/submit \
-H "Authorization: Bearer dsn_SEU_TOKEN"
Referência completa: Swagger UI e OpenAPI JSON.
Em desenvolvimento
CLI devsnorte
Ainda não lançada
Uma CLI fina sobre esta mesma API (para consultar e submeter projetos pelo terminal, inclusive via Claude Code, Codex ou Cursor) está planejada. Acompanhe o andamento em issues/162 . Enquanto isso, os exemplos de curl acima cobrem o mesmo caso de uso.
Regras
Moderação e limites de uso
Moderação
Projetos criados via API entram como rascunho. Ao enviá-los para revisão, vão para
a fila de moderação (pending_review) — exceto para
usuários de confiança, aprovados automaticamente. Nenhum projeto é publicado sem
esse passo.
Rate limit
300 requisições/minuto por IP, 60/minuto por token, e 10 submissões para moderação
por usuário por dia. Respeite o header Retry-After
em respostas 429.
Para ir além