Polity Atlas
البناء · واجهة API المفتوحة v1

واجهة API والبيانات المفتوحة

كل كيان وادعاء ومصدر وتجربة متاح في صورة بيانات مهيكلة. القراءة لا تحتاج إلى مفتاح، وتسري حدود استخدام سخية.

عنوان URL الأساسيhttps://polityatlas.org/api/v1
الترخيصالمحتوى CC BY-SA 4.0 · البيانات ODbL

المصادقة

القراءة مجهولة الهوية. أما الكتابة فتستخدم ملف تعريف الارتباط لجلسة Django: اطلب GET /auth/csrf مرة واحدة، ثم أرسل الرمز في X-CSRFToken مع طلبات POST وPATCH وDELETE مع تضمين بيانات الاعتماد.

ترقيم الصفحات والأخطاء

تقبل القوائم المعاملين page وpage_size وتعيد {"items", "count", "page", "page_size"}. وتكون الأخطاء دائمًا بصيغة {"detail": "…"} مع رمز حالة دالّ (400 أو 401 أو 403 أو 404 أو 409 أو 422 أو 429).

التوطين

أضف ?lang=ru (أو أرسل Accept-Language) للحصول على الحقول بالروسية؛ وتعود الترجمات المفقودة إلى الإنجليزية.

GET

/entities/{slug}

يعيد كيانًا مع علاقاته مجمّعة بحسب النوع، وادعاءاته مع الأدلة والمصادر، وتقييماته.

curl "https://polityatlas.org/api/v1/entities/polycentric-law?lang=ar"
الاستجابة · 200
{
  "id": 11,
  "slug": "polycentric-law",
  "kind": "concept",
  "title": "Polycentric law",
  "summary": "Several coexisting centres of rule-making and dispute resolution.",
  "review_state": "published",
  "last_verified_at": "2026-10-02T00:00:00Z",
  "relations": [
    {
      "type": "implements",
      "direction": "incoming",
      "label": "implemented by",
      "items": [{ "entity": { "slug": "arbitration", "kind": "mechanism" } }]
    }
  ],
  "claims": [{
    "id": 318,
    "text": "…",
    "epistemic_status": "disputed",
    "verification_status": "verified",
    "evidence": [{ "stance": "supports", "source": { "id": 41 } }]
  }]
}

المعرفة

GET/entitiesالمرشحات: kind, theme, tag, q
GET/entities/{slug}كيان مع العلاقات والادعاءات والتقييمات
GET/entities/{slug}/graphالشبكة المحيطة بالكيان، العمق 1–2
GET/graphالرسم البياني المنشور كاملًا؛ kinds, theme
GET/claims/{id}ادعاء وأدلة ومصادر ونزاعات مفتوحة
GET/sourcesالمرشحات: type, q, primary
GET/glossaryالمصطلحات؛ letter, q
GET/searchq, kind, mode=keyword|semantic
POST/askإجابة مبنية على الادعاءات المنشورة فقط

الأطلس الحي

GET/experimentsالمرشحات، ومنها bbox, autonomy, uses_ai
GET/experiments/geojsonGeoJSON FeatureCollection
GET/experiments/networkكيانات سياسية شبكية وآليات مشتركة
GET/experiments/facetsالأعداد لكل قيمة من قيم الوجه

المستكشف والمرصد

GET/criteriaمعايير التقييم
POST/explorer/compareمقارنة موزونة وفق معايير معروفة
GET/observatorykind: signal, news, research, briefing
GET/scenariosالمحرّكات والمؤشرات والاحتمالية بالكلمات

Polity Lab

GET/lab/optionsأبعاد التهيئة وسيناريوهات الاختبار تحت الضغط
POST/lab/projects/{id}/analyzeتحليل الاتساق القائم على القواعد
GET/repository/componentsمكوّنات مؤسسية مؤرشفة الإصدارات
GET/export/entities.jsonlتصدير مجمّع، JSON Lines

الأنطولوجيا

المفردات التي يستخدمها كل سجل. ويمكن للمحررين جلب المخطط الكامل، بما فيه تعريفات السمات، من /cp/ontology.

أنواع الكياناتمفهومconceptآليةmechanismنظريةtheoryمفكرthinkerتجربةexperimentنوع مؤسسةinstitution_typeأيديولوجياideologyorganisationorganisation
أنواع العلاقاتتطبّقimplementsاختُبرت فيtested_inاقترحهاproposed_byأثّر فيinfluencedتنتقدcriticisesبديلalternative_toجزء منpart_ofتستخدم آليةuses_mechanismذات صلة بـrelated_to
الحالة المعرفيةراسخestablishedنظريةtheoryمحل خلافdisputedفرضيةhypothesisتوقّعforecast
حالة التحققغير متحقَّق منهunverifiedصيغ بالذكاء الاصطناعيai_draftedقيد المراجعةin_reviewمتحقَّق منهverifiedمرفوضrejected
التصدير المجمّعالرسم البياني الكامل بصيغة JSON Lines، يُحدَّث ليليًا.
GET /export/entities.jsonl