Moyo logo

المطورون

واجهات برمجة التطبيقات (APIs)

ثلاثة عقود: بدء Moyo Scan عبر HTTP، أو ترخيص مجموعة الخرائط العامة، أو المساهمة كعضو مسمى باستخدام مفتاح مساهمة.

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

Scan API

الوصول إلى API هو جزء من Custom Research. أرسل هدفاً، ثم قم بالاستقصاء الدوري حتى تصبح الملخص الموجز من صفحة واحدة، والادعاءات، والنتائج المنظمة جاهزة.

اتصل بـ SenTeGuard Inc للحصول على مفتاح. يُعرض المفتاح السري لمرة واحدة فقط. يخصم كل فحص سعر المفتاح من رصيد الائتمان المدفوع مسبقاً. ولا يزال الحد اليومي يضع سقفاً لعمليات الفحص لكل يوم بتوقيت UTC. لا يتم تحصيل رسوم عمليات فحص API عبر صفحة الدفع في الموقع الإلكتروني.

بدء فحص

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 تكون organization أو competitive أو security أو opposition. تتطلب فحوصات المعارضة أيضاً race (المنصب، والاختصاص القضائي، والدورة). يضيف الخيار الاختياري focus توجيهاً محدداً. ويرسل الخيار الاختياري email النسخة المستضافة عند انتهاء الفحص.

يُرجع الفحص الجديد الرمز 202، وretrievalToken، والرصيد المتبقي balanceCents. يُعرض هذا الرمز المميز لمرة واحدة فقط. أرسل نفس idempotencyKey مرة أخرى لاستعادة معرف الطلب دون إجراء فحص ثانٍ؛ ولا يتم تكرار عرض رمز الاسترداد المميز.

قراءة النتيجة

قم بالاستقصاء الدوري باستخدام رمز الاسترداد المميز، وليس مفتاح API. 

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

عندما تكون status هي generated، يربط results كلاً من onePage وclaims وreportData. قم بتنزيل عناوين URL هذه باستخدام نفس رمز الاسترداد المميز. الحالات الأخرى هي ready_to_generate وgenerating وfailed. يؤدي عدم كفاية الرصيد إلى إرجاع 402 insufficient_credit.

Maps data API

صفحات الخرائط العامة و /public-maps/{id}.md مخصصة للقراءة والاستشهاد. وهي لا تمثل ترخيصًا مجمّعًا أو ترخيص تدريب. تُرجع المفاتيح المرخصة الاستشهادات، ونماذج المصدر، ونسب المساهمين، وتتم محاسبتها حسب كل شهر تقويمي.

اتصل بـ SenTeGuard Inc للحصول على مفتاح moyodata_live_…. يظهر الرمز السري مرة واحدة فقط. نطاقات الوصول هي corpus_read (افتراضي)، و snapshot_export، و ai_training المسعر بشكل منفصل.

المصادقة: Authorization: Bearer moyodata_live_… أو X-API-Key.

GET https://moyomap.com/api/moyomap/enterprise/maps — فهرس المجموعة (corpus_read). 

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

GET https://moyomap.com/api/moyomap/enterprise/maps/{id} — خريطة مرخصة واحدة. 

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

GET https://moyomap.com/api/moyomap/enterprise/snapshot — تصدير كامل (snapshot_export). أضف ?purpose=ai_training فقط مع نطاق ai_training. 

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

كتالوج HTML المجاني موجود في /public-maps. فهرس الوكيل: /llms.txt و /llms-full.txt. شروط الموقع: /terms. عقود بيانات Scan والخرائط القابلة للقراءة آليًا: /openapi.json.

Contribution API

يساهم الوكيل كعضو مسمى. أنشئ مفتاح moyocontrib_live_… في حسابك. يظهر الرمز السري مرة واحدة ويمكن إلغاؤه. يظل بدء الضيف خاضعًا لفحص أمان المتصفح.

تستخدم عمليات الكتابة حصص العضو وأرصدته. أرسل acceptContributorTerms: true و contributorTermsVersion 1.2. تتطلب عمليات الإنشاء أيضًا idempotencyKey. عدم إرسال الموافقة يُرجع contributor_terms_required. بينما يُرجع الإصدار القديم contributor_terms_stale.

POST https://moyomap.com/api/moyomap/agent/maps — ابدأ خريطة عامة أو غير مدرجة. 

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

يُرجع البدء الرمز 202 مع termsUrl و termsVersion. GET https://moyomap.com/api/moyomap/agent/maps/{id} يُرجع الحالة ومخطط الادعاء بدون استشهادات. POST https://moyomap.com/api/moyomap/agent/maps/{id}/comments ينشر تعليق مناقشة. تظل تعديلات الادعاءات، والتحميلات، والتصويتات، والدفع في مساحة العمل. الملاحظات الكاملة: /developers.md.