AD
API diretorio.dev
API REST pública para consultar e gerenciar integrações, projetos e estatísticas do diretorio.dev.
TipoAPI REST
Base URLhttps://diretorio.dev/api
AutenticaçãoOAuth 2.0
https://diretorio.dev/api
Endpoints
- GET/api/mcps.json200Lista todas as integrações aprovadas, ordenadas por popularidade. Usa cache Redis.
- GET/api/mcps/:slug200404Obtém detalhes de uma integração pelo slug. Integrações não aprovadas retornam 404.
- POST/api/mcps200401400Cadastra nova integração (MCP, REST ou GraphQL). Gera slug, envia webhook Discord e email de confirmação.
- PATCH/api/mcps/:slug200401403404Atualiza campos da integração (nome, descrição, categorias, configurações MCP/API, auth). Invalida cache.
- POST/api/mcps/:slug/appeal200401403Recorre de uma rejeição — volta a integração para status pendente.
- POST/api/mcps/auto-register200401403Registra em lote múltiplas superfícies de integração descobertas para um projeto.
- GET/api/projetos.json200Lista todos os projetos (exceto admin_only), ordenados por nome. Usa cache Redis.
- GET/api/projetos/:slug200404Obtém detalhes de um projeto e suas integrações. Owner/admin vê todas; anônimo vê só aprovadas.
- POST/api/projetos200401400Cria novo projeto. Se domínio ou url_metadados for informado, faz descoberta automática de integrações.
- PATCH/api/projetos/:slug200401403Atualiza projeto. Se domínio mudou, re-descobre integrações automaticamente.
- GET/api/stats.json200Retorna estatísticas: total de projetos, integrações aprovadas, categorias e contribuidores. Usa cache Redis.
- GET/api/sitemap.xml200Gera sitemap XML com rotas estáticas, projetos e integrações aprovadas.
- POST/api/discover200401Faz probe em um domínio para descobrir integrações automaticamente. Cache de 1 hora via Redis.
- POST/api/import/openapi200401Importa especificação OpenAPI (JSON ou YAML) via URL ou conteúdo, extraindo endpoints e metadados.
- POST/api/account/delete200401Exclui conta do usuário via admin API do Supabase.
- GET/api/auth/oauth302400Redireciona para o fluxo OAuth do Supabase (Google ou GitHub). Query param obrigatório: provider.
- GET/api/auth/callback302Callback OAuth do Supabase. Redireciona para /login com hash contendo access_token.
- PATCH/api/admin/mcps/:slug/status200401403Aprova ou rejeita uma integração (admin). Envia email de notificação ao owner.
- GET/api/admin/projetos200401403Lista todos os projetos (incluindo admin_only) para o painel administrativo.
- PATCH/api/admin/projetos/:slug/admin-only200401403Alterna flag admin_only de um projeto (visível apenas para admins).
- POST/api/cron/discovery200401Cron job que sincroniza integrações de todos os projetos com domínio ou url_metadados. Requer CRON_SECRET.
DetalhesCredencial
Cadastradojul/2026
Docsdocs ↗
HeaderAuthorization
EsquemaBearer
Faça login em diretorio.dev com Google ou GitHub. Após o login, o token de acesso JWT é automaticamente gerado e gerenciado pela sessão. Para usar via API, extraia o access_token da URL após o callback OAuth ou da sessão no localStorage e envie no header Authorization: Bearer <token>.