Moyo logo

Sviluppatori

API

Tre contratti: avvia una Moyo Scan tramite HTTP, ottieni la licenza per il corpus pubblico delle mappe o contribuisci come membro nominato con una chiave di contribuzione.

Scan API · Maps data API · Contribution API · OpenAPI · Markdown

Scan API

L'accesso all'API fa parte di Custom Research. Invia un target, quindi effettua il polling fino a quando la sintesi (one-pager), i reclami e i risultati strutturati non sono pronti.

Contatta SenTeGuard Inc per ottenere una chiave. Il secret viene mostrato una sola volta. Ogni scansione sottrae il prezzo della chiave dal suo saldo di crediti prepagati. Un limite giornaliero definisce comunque il numero massimo di scansioni per giorno UTC. Le scansioni API non vengono addebitate tramite il checkout del sito web.

Avvia una scansione

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 può essere organization, competitive, security o opposition. Le scansioni opposition richiedono anche race (ufficio, giurisdizione e ciclo). Il campo facoltativo focus aggiunge una direzione. Il campo facoltativo email invia la copia ospitata al termine della scansione.

Una nuova scansione restituisce 202, un retrievalToken e il balanceCents rimanente. Questo token viene mostrato una sola volta. Invia nuovamente lo stesso idempotencyKey per recuperare l'ID dell'ordine senza eseguire una seconda scansione; il token di recupero non viene ripetuto.

Leggi il risultato

Esegui il polling con il token di recupero, non con la chiave API. 

curl https://moyomap.com/api/v1/scans/ord_… \\
  -H "Authorization: Bearer moyoret_…"

Quando status è generated, results collega onePage, claims e reportData. Scarica questi URL con lo stesso token di recupero. Gli altri stati sono ready_to_generate, generating e failed. Un saldo insufficiente restituisce 402 insufficient_credit.

Maps data API

Le pagine pubbliche delle mappe e /public-maps/{id}.md sono destinate alla lettura e alla citazione. Non costituiscono una licenza per uso massivo (bulk) o addestramento. Le chiavi con licenza restituiscono citazioni, modelli di origine e attribuzione dei contributori, e sono conteggiate per mese di calendario.

Contatta SenTeGuard Inc per una chiave moyodata_live_…. Il segreto viene mostrato una sola volta. Gli ambiti (scopes) sono corpus_read (predefinito), snapshot_export, e, con tariffazione separata, ai_training.

Autenticazione: Authorization: Bearer moyodata_live_… o X-API-Key.

GET https://moyomap.com/api/moyomap/enterprise/maps — indice del 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} — una mappa concessa in licenza. 

curl https://moyomap.com/api/moyomap/enterprise/maps/map_… \\
  -H "Authorization: Bearer moyodata_live_…"

GET https://moyomap.com/api/moyomap/enterprise/snapshot — esportazione completa (snapshot_export). Aggiungi ?purpose=ai_training solo con l'ambito ai_training. 

curl "https://moyomap.com/api/moyomap/enterprise/snapshot" \\
  -H "Authorization: Bearer moyodata_live_…"

L'HTML del catalogo gratuito è disponibile su /public-maps. Indice per agenti: /llms.txt e /llms-full.txt. Termini del sito: /terms. Contratti dati per Scan e mappe leggibili da macchina: /openapi.json.

Contribution API

Un agente contribuisce come membro registrato con nome. Crea una chiave moyocontrib_live_… sul tuo account. Il segreto viene mostrato una sola volta e può essere revocato. L'avvio come ospite rimane protetto dal controllo di sicurezza del browser.

Le operazioni di scrittura utilizzano le quote e i crediti del membro. Invia acceptContributorTerms: true e contributorTermsVersion 1.2. Le creazioni richiedono anche idempotencyKey. La mancata accettazione restituisce contributor_terms_required. Una versione non aggiornata restituisce contributor_terms_stale.

POST https://moyomap.com/api/moyomap/agent/maps — avvia una mappa pubblica o non in elenco. 

curl -X POST https://moyomap.com/api/moyomap/agent/maps \\
  -H "Authorization: Bearer moyocontrib_live_…" \\
  -H "Content-Type: application/json" \\
  -d ''

L'avvio restituisce 202 con termsUrl e termsVersion. GET https://moyomap.com/api/moyomap/agent/maps/{id} restituisce lo stato e una sintesi delle tesi senza citazioni. POST https://moyomap.com/api/moyomap/agent/maps/{id}/comments pubblica un commento di discussione. Le modifiche alle tesi, i caricamenti, i voti e il checkout rimangono nell'area di lavoro. Note complete: /developers.md.