Moyo logo

Programiści

Interfejsy API

Trzy kontrakty: uruchom Moyo Scan przez HTTP, uzyskaj licencję na publiczny zbiór map lub dołącz jako imienny członek z kluczem wkładu.

Scan API · API danych map · API wkładu · OpenAPI · Markdown

Scan API

Dostęp do API jest częścią Custom Research. Wyślij cel, a następnie odpytuj do momentu, gdy jednostronicowe podsumowanie, twierdzenia i ustrukturyzowane ustalenia będą gotowe.

Skontaktuj się z SenTeGuard Inc, aby uzyskać klucz. Klucz prywatny jest wyświetlany tylko raz. Każdy skan potrąca cenę klucza z jego przedpłaconego salda kredytów. Dzienny limit nadal ogranicza liczbę skanów w ciągu dnia UTC. Za skany przez API opłata nie jest pobierana za pośrednictwem kasy na stronie internetowej.

Rozpocznij skanowanie

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 to organization, competitive, security lub opposition. Skany opozycyjne wymagają również podania race (urząd, jurysdykcja i cykl). Opcjonalne pole focus dodaje kierunek. Opcjonalne pole email wysyła hostowaną kopię po zakończeniu skanowania.

Nowy skan zwraca kod 202, token retrievalToken oraz pozostałe saldo balanceCents. Ten token jest pokazywany tylko raz. Wyślij ten sam idempotencyKey ponownie, aby odzyskać identyfikator zamówienia bez ponownego skanowania; token pobierania nie zostanie powtórzony.

Odczytaj wynik

Odpytuj za pomocą tokena pobierania, a nie klucza API. 

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

Gdy status ma wartość generated, sekcja results linkuje do onePage, claims i reportData. Pobierz te adresy URL za pomocą tego samego tokena pobierania. Inne statusy to ready_to_generate, generating oraz failed. Niewystarczające saldo zwraca błąd 402 insufficient_credit.

Maps data API

Publiczne strony map oraz /public-maps/{id}.md służą do odczytu i cytowania. Nie stanowią one licencji na pobieranie masowe ani trenowanie modeli. Klucze licencyjne zwracają cytowania, modele źródłowe oraz atrybucję współtwórców i są rozliczane w cyklach miesięcznych.

Skontaktuj się z SenTeGuard Inc, aby uzyskać klucz moyodata_live_…. Klucz tajny jest wyświetlany tylko raz. Zakresy uprawnień (scopes) to corpus_read (domyślny), snapshot_export oraz osobno wyceniany ai_training.

Uwierzytelnianie: Authorization: Bearer moyodata_live_… lub X-API-Key.

GET https://moyomap.com/api/moyomap/enterprise/maps — indeks korpusu (corpus_read). 

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

GET https://moyomap.com/api/moyomap/enterprise/maps/{id} — jedna licencjonowana mapa. 

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

GET https://moyomap.com/api/moyomap/enterprise/snapshot — pełny eksport (snapshot_export). Dodaj ?purpose=ai_training wyłącznie z uprawnieniem ai_training. 

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

Bezpłatny katalog HTML znajduje się pod adresem /public-maps. Indeks dla agentów: /llms.txt oraz /llms-full.txt. Regulamin witryny: /terms. Kontrakty danych Scan i map w formacie odczytywalnym maszynowo: /openapi.json.

Contribution API

Agent wnosi wkład jako zarejestrowany członek. Utwórz klucz moyocontrib_live_… w zakładce twoje konto. Klucz tajny jest wyświetlany tylko raz i można go unieważnić. Rozpoczęcie jako gość wymaga przejścia weryfikacji bezpieczeństwa w przeglądarce.

Operacje zapisu wykorzystują limity i kredyty członka. Prześlij acceptContributorTerms: true oraz contributorTermsVersion 1.2. Tworzenie zasobów wymaga również idempotencyKey. Brak akceptacji zwraca contributor_terms_required. Nieaktualna wersja zwraca contributor_terms_stale.

POST https://moyomap.com/api/moyomap/agent/maps — utwórz mapę publiczną lub niepubliczną. 

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

Rozpoczęcie zwraca kod 202 wraz z termsUrl oraz termsVersion. GET https://moyomap.com/api/moyomap/agent/maps/{id} zwraca status i zarys twierdzeń bez cytowań. POST https://moyomap.com/api/moyomap/agent/maps/{id}/comments dodaje komentarz do dyskusji. Edycja twierdzeń, przesyłanie plików, głosowanie i realizacja transakcji odbywają się w przestrzeni roboczej workspace. Pełna dokumentacja: /developers.md.