Para desenvolvedores e agentes

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 endpoint GET.
  • read_write — além do acima, POST, PUT, PATCH e DELETE.

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

Links úteis