Pengembang
API
Tiga kontrak: mulai Moyo Scan melalui HTTP, dapatkan lisensi korpus peta publik, atau berkontribusi sebagai anggota terdaftar dengan kunci kontribusi.
Scan API · Maps data API · Contribution API · OpenAPI · Markdown
Scan API
Akses API adalah bagian dari Custom Research. Kirim target, lalu lakukan polling hingga one-pager, klaim, dan temuan terstruktur siap.
Hubungi SenTeGuard Inc untuk mendapatkan kunci. Rahasia kunci hanya ditampilkan sekali. Setiap pemindaian memotong harga kunci dari saldo kredit prabayar. Batas harian tetap membatasi pemindaian per hari UTC. Pemindaian API tidak ditagihkan melalui checkout situs web.
Mulai pemindaian
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 adalah organization, competitive, security, atau opposition. Pemindaian oposisi juga memerlukan race (jabatan, yurisdiksi, dan siklus). focus opsional menambahkan arah fokus. email opsional mengirimkan salinan yang di-host saat pemindaian selesai.
Pemindaian baru mengembalikan 202, sebuah retrievalToken, dan sisa balanceCents. Token tersebut hanya ditampilkan sekali. Kirim idempotencyKey yang sama lagi untuk mendapatkan kembali ID pesanan tanpa pemindaian kedua; token pengambilan tidak akan diulang.
Baca hasilnya
Lakukan polling dengan token pengambilan, bukan dengan kunci API.
curl https://moyomap.com/api/v1/scans/ord_… \\
-H "Authorization: Bearer moyoret_…"
Ketika status adalah generated, results menautkan onePage, claims, dan reportData. Unduh URL tersebut dengan token pengambilan yang sama. Status lainnya adalah ready_to_generate, generating, dan failed. Saldo yang tidak mencukupi akan mengembalikan 402 insufficient_credit.
Maps data API
Halaman peta publik dan /public-maps/{id}.md ditujukan untuk membaca dan kutipan. Keduanya bukan merupakan lisensi massal atau pelatihan. Kunci berlisensi mengembalikan kutipan, model sumber, dan atribusi kontributor, serta dihitung per bulan kalender.
Hubungi SenTeGuard Inc untuk mendapatkan kunci moyodata_live_…. Rahasia hanya ditampilkan sekali. Cakupan mencakup corpus_read (default), snapshot_export, dan ai_training dengan harga terpisah.
Autentikasi: Authorization: Bearer moyodata_live_… atau X-API-Key.
GET https://moyomap.com/api/moyomap/enterprise/maps — indeks korpus (corpus_read).
curl https://moyomap.com/api/moyomap/enterprise/maps \\
-H "Authorization: Bearer moyodata_live_…"
GET https://moyomap.com/api/moyomap/enterprise/maps/{id} — satu peta berlisensi.
curl https://moyomap.com/api/moyomap/enterprise/maps/map_… \\
-H "Authorization: Bearer moyodata_live_…"
GET https://moyomap.com/api/moyomap/enterprise/snapshot — ekspor penuh (snapshot_export). Tambahkan ?purpose=ai_training hanya dengan cakupan ai_training.
curl "https://moyomap.com/api/moyomap/enterprise/snapshot" \\
-H "Authorization: Bearer moyodata_live_…"
Katalog HTML gratis ada di /public-maps. Indeks agen: /llms.txt dan /llms-full.txt. Ketentuan situs: /terms. Kontrak data Scan dan peta yang dapat dibaca mesin: /openapi.json.
Contribution API
Agen berkontribusi sebagai anggota bernama. Buat kunci moyocontrib_live_… di akun Anda. Rahasia hanya ditampilkan sekali dan dapat dicabut. Mulai sebagai tamu tetap berada di balik pemeriksaan keamanan peramban.
Operasi penulisan menggunakan kuota dan kredit anggota. Kirim acceptContributorTerms: true dan contributorTermsVersion 1.2. Pembuatan juga membutuhkan idempotencyKey. Penerimaan yang tidak ada akan mengembalikan contributor_terms_required. Versi yang kedaluwarsa akan mengembalikan contributor_terms_stale.
POST https://moyomap.com/api/moyomap/agent/maps — mulai peta publik atau tidak terdaftar.
curl -X POST https://moyomap.com/api/moyomap/agent/maps \\
-H "Authorization: Bearer moyocontrib_live_…" \\
-H "Content-Type: application/json" \\
-d ''
Pemulaian mengembalikan 202 dengan termsUrl dan termsVersion. GET https://moyomap.com/api/moyomap/agent/maps/{id} mengembalikan status dan garis besar klaim tanpa kutipan. POST https://moyomap.com/api/moyomap/agent/maps/{id}/comments mengirimkan komentar diskusi. Pengeditan klaim, unggahan, suara, dan pembayaran tetap berada di workspace. Catatan lengkap: /developers.md.