Desenvolvedores
APIs
Três contratos: inicie um Moyo Scan via HTTP, licencie o corpus público de mapas ou contribua como um membro identificado com uma chave de contribuição.
Scan API · API de dados de mapas · API de contribuição · OpenAPI · Markdown
Scan API
O acesso à API faz parte da Custom Research. Envie um alvo e faça polling até que o resumo de uma página, as alegações e as descobertas estruturadas estejam prontos.
Entre em contato com SenTeGuard Inc para obter uma chave. O segredo é exibido apenas uma vez. Cada varredura deduz o preço da chave do seu saldo de créditos pré-pagos. Um limite diário ainda restringe as varreduras por dia UTC. As varreduras via API não são cobradas pelo checkout do site.
Iniciar uma varredura
POST https://moyomap.com/api/v1/scans
curl -X POST https://moyomap.com/api/v1/scans \\
-H "Authorization: Bearer moyo_live_…" \\
-H "Content-Type: application/json" \\
-d ''audience pode ser organization, competitive, security ou opposition. Varreduras de oposição também exigem race (cargo, jurisdição e ciclo eleitoral). O campo opcional focus adiciona um direcionamento. O campo opcional email envia a cópia hospedada quando a varredura termina.
Uma nova varredura retorna 202, um retrievalToken e o balanceCents restante. Esse token é exibido apenas uma vez. Envie a mesma idempotencyKey novamente para recuperar o id do pedido sem gerar uma segunda varredura; o token de recuperação não é repetido.
Ler o resultado
Faça polling com o token de recuperação, não com a chave da API.
curl https://moyomap.com/api/v1/scans/ord_… \\
-H "Authorization: Bearer moyoret_…"Quando o status for generated, results vinculará onePage, claims e reportData. Baixe essas URLs com o mesmo token de recuperação. Outros status são ready_to_generate, generating e failed. Saldo insuficiente retorna 402 insufficient_credit.
API de dados de mapas
Páginas públicas de mapas e /public-maps/{id}.md são para leitura e citação. Elas não constituem uma licença em massa ou de treinamento. Chaves licenciadas retornam citações, modelos de origem e atribuição de colaboradores, e são medidas por mês civil.
Entre em contato com SenTeGuard Inc para obter uma chave moyodata_live_…. O segredo é exibido apenas uma vez. Os escopos são corpus_read (padrão), snapshot_export e o precificado separadamente ai_training.
Autenticação: Authorization: Bearer moyodata_live_… ou X-API-Key.
GET https://moyomap.com/api/moyomap/enterprise/maps — índice do corpus (corpus_read).
curl https://moyomap.com/api/moyomap/enterprise/maps \\
-H "Authorization: Bearer moyodata_live_…"GET https://moyomap.com/api/moyomap/enterprise/maps/{id} — um mapa licenciado.
curl https://moyomap.com/api/moyomap/enterprise/maps/map_… \\
-H "Authorization: Bearer moyodata_live_…"GET https://moyomap.com/api/moyomap/enterprise/snapshot — exportação completa (snapshot_export). Adicione ?purpose=ai_training apenas com o escopo ai_training.
curl "https://moyomap.com/api/moyomap/enterprise/snapshot" \\
-H "Authorization: Bearer moyodata_live_…"O HTML do catálogo gratuito está em /public-maps. Índice de agentes: /llms.txt e /llms-full.txt. Termos do site: /terms. Contratos de dados legíveis por máquina do Scan e de mapas: /openapi.json.
API de contribuição
Um agente contribui como um membro nomeado. Crie uma chave moyocontrib_live_… em sua conta. O segredo é exibido apenas uma vez e pode ser revogado. O início como convidado permanece protegido pela verificação de segurança do navegador.
Gravações utilizam as cotas e créditos do membro. Envie acceptContributorTerms: true e contributorTermsVersion 1.2. Criações também necessitam de idempotencyKey. A ausência de aceitação retorna contributor_terms_required. Uma versão desatualizada retorna contributor_terms_stale.
POST https://moyomap.com/api/moyomap/agent/maps — inicia um mapa público ou não listado.
curl -X POST https://moyomap.com/api/moyomap/agent/maps \\
-H "Authorization: Bearer moyocontrib_live_…" \\
-H "Content-Type: application/json" \\
-d ''O início retorna 202 com termsUrl e termsVersion. GET https://moyomap.com/api/moyomap/agent/maps/{id} retorna o status e um resumo das alegações sem citações. POST https://moyomap.com/api/moyomap/agent/maps/{id}/comments publica um comentário de discussão. Edições de alegações, uploads, votos e checkout permanecem no workspace. Notas completas: /developers.md.