تفضيلات الخصوصية

الوظائف الضرورية

مطلوبة للأمان ووظائف الموقع الأساسية.

مفعّلة دائمًا

تحليلات الاستخدام الاختيارية

هل تسمح بتحليلات استخدام PostHog؟ يمكنك تغيير اختيارك في أي وقت من التذييل.

السماح أيضاً بتسجيل الجلسات لإعادة عرضها على هذا الموقع العام

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

يتطلب التحليلات؛ إعادة تشغيل الموقع متوقفة افتراضيًا.

لا تفعّل تحليلات المتصفح تحليلات الحساب.

يُحمّل البحث عند استخدامه فقط. تصفّح جميع الفئات أدناه.

البحث والموجزات الموثقة بالمراجع

قراءة حالة جلب مصدر عام

قراءة إيصال الجلب نفسه، بما فيه نص المصدر غير الموثوق عند توفره؛ لا يبدأ جلبًا آخر مطلقًا. يتطلب agent:research.

POST /research-api/evidence/status

مراجعة العقد: · sha256:ab393e91e9b7f18a

نظرة عامة

قراءة إيصال الجلب نفسه، بما فيه نص المصدر غير الموثوق عند توفره؛ لا يبدأ جلبًا آخر مطلقًا. يتطلب agent:research.

قد يعني نجاح HTTP قبول الطلب لا اكتماله. للعمل الخلفي، احفظ المعرّف المُعاد وتابع العملية نفسها حتى تنتهي. لا يُعدّ المنشور المجدول أوالمقبول منشوراً حتى تأكيد المنصة؛ انتهاء مهلة العميل لا يثبت النتيجة.

المصادقة والأذونات

فئات بيانات الاعتماد المقبولة
user_session, delegated_oauth, personal_access_token
إمكانية مفوّضة
agent:research
الحد الأدنى لدور مساحة العمل
viewer
نطاق الوصول
الموارد التي يحق لهذا المستخدم الوصول إليها
تلزم موافقة تشمل جميع مساحات العمل
لا
يغيّر الحالة
لا
متى تُعدّ العملية مكتملة
current authorized retrieval state; expired source content is redacted

لا يستخدم الرمز إلا حقوق مالكه. يفحص كل طلب عضوية مساحة العمل وملكية المورد والمساحات المحددة والإمكانات الممنوحة. يغيّر core و full الأدوات المعروضة؛ ولا يمنحان وصولاً.

حقول الطلب

تعني «مطلوب» داخل الكائن الأب والفرع المختار. الحقل الابن المطلوب لا يجعل الأب الاختياري مطلوباً. نُسخت القواعد وأسماء الحقول أدناه من العقد.

حقول الطلب
الحقل / الفرعالنوع / مطلوبالقيود
$objectمطلوب في العنصر الأب
  • additionalProperties: false
workspace_idstringمطلوب في العنصر الأب
  • format: "uuid"
  • pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
mutation_idstringمطلوب في العنصر الأب
  • format: "uuid"
  • pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
مخطط JSON Schema الكامل
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "workspace_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "mutation_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    }
  },
  "required": [
    "workspace_id",
    "mutation_id"
  ],
  "additionalProperties": false
}

الاستجابة والاكتمال

رموز نجاح HTTP: 200. عندما تكتمل العملية: current authorized retrieval state; expired source content is redacted.

قد يعني نجاح HTTP قبول الطلب لا اكتماله. للعمل الخلفي، احفظ المعرّف المُعاد وتابع العملية نفسها حتى تنتهي. لا يُعدّ المنشور المجدول أوالمقبول منشوراً حتى تأكيد المنصة؛ انتهاء مهلة العميل لا يثبت النتيجة.

تعني «مطلوب» داخل الكائن الأب والفرع المختار. الحقل الابن المطلوب لا يجعل الأب الاختياري مطلوباً. نُسخت القواعد وأسماء الحقول أدناه من العقد.

الاستجابة والاكتمال
الحقل / الفرعالنوع / مطلوبالقيود
$objectمطلوب في العنصر الأب—
retrievalobject | nullمطلوب في العنصر الأب—
retrievalanyOf 1objectمطلوب في العنصر الأب—
retrieval.idanyOf 1stringمطلوب في العنصر الأب
  • format: "uuid"
  • pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
retrieval.workspace_idanyOf 1stringمطلوب في العنصر الأب
  • format: "uuid"
  • pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
retrieval.mutation_idanyOf 1stringمطلوب في العنصر الأب
  • format: "uuid"
  • pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
retrieval.stateanyOf 1stringمطلوب في العنصر الأب
  • enum: ["pending","running","completed","cancelled","unconfirmed","expired"]
retrieval.kindanyOf 1string | nullمطلوب في العنصر الأب—
retrieval.kindanyOf 1 / anyOf 1stringمطلوب في العنصر الأب
  • enum: ["url_text","published_captions"]
retrieval.kindanyOf 1 / anyOf 2nullمطلوب في العنصر الأب—
retrieval.created_atanyOf 1stringمطلوب في العنصر الأب
  • format: "date-time"
  • pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
retrieval.settled_atanyOf 1string | nullمطلوب في العنصر الأب—
retrieval.settled_atanyOf 1 / anyOf 1stringمطلوب في العنصر الأب
  • format: "date-time"
  • pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
retrieval.settled_atanyOf 1 / anyOf 2nullمطلوب في العنصر الأب—
retrieval.valid_untilanyOf 1stringمطلوب في العنصر الأب
  • format: "date-time"
  • pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
retrieval.resultanyOf 1object | nullمطلوب في العنصر الأب—
retrieval.resultanyOf 1 / anyOf 1objectمطلوب في العنصر الأب—
retrieval.result.kindanyOf 1 / anyOf 1stringمطلوب في العنصر الأب
  • enum: ["url_text","published_captions"]
retrieval.result.statusanyOf 1 / anyOf 1stringمطلوب في العنصر الأب
  • enum: ["ready","partial","blocked","unsupported","empty","rate_limited","unavailable","cancelled"]
retrieval.result.textanyOf 1 / anyOf 1stringمطلوب في العنصر الأب
  • maxLength: 20000
retrieval.result.titleanyOf 1 / anyOf 1string | nullمطلوب في العنصر الأب—
retrieval.result.titleanyOf 1 / anyOf 1 / anyOf 1stringمطلوب في العنصر الأب
  • minLength: 1
  • maxLength: 200
retrieval.result.titleanyOf 1 / anyOf 1 / anyOf 2nullمطلوب في العنصر الأب—
retrieval.result.descriptionanyOf 1 / anyOf 1string | nullمطلوب في العنصر الأب—
retrieval.result.descriptionanyOf 1 / anyOf 1 / anyOf 1stringمطلوب في العنصر الأب
  • minLength: 1
  • maxLength: 2000
retrieval.result.descriptionanyOf 1 / anyOf 1 / anyOf 2nullمطلوب في العنصر الأب—
retrieval.result.segmentsanyOf 1 / anyOf 1arrayمطلوب في العنصر الأب
  • maxItems: 1000
retrieval.result.segments[]anyOf 1 / anyOf 1objectاختياري / عنصر—
retrieval.result.segments[].start_msanyOf 1 / anyOf 1integerمطلوب في العنصر الأب
  • minimum: 0
  • maximum: 9007199254740991
retrieval.result.segments[].end_msanyOf 1 / anyOf 1integerمطلوب في العنصر الأب
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
retrieval.result.segments[].textanyOf 1 / anyOf 1stringمطلوب في العنصر الأب
  • minLength: 1
  • maxLength: 20000
retrieval.result.provenanceanyOf 1 / anyOf 1objectمطلوب في العنصر الأب—
retrieval.result.provenance.source_urlanyOf 1 / anyOf 1string | nullمطلوب في العنصر الأب—
retrieval.result.provenance.source_urlanyOf 1 / anyOf 1 / anyOf 1stringمطلوب في العنصر الأب
  • format: "uri"
  • maxLength: 2048
retrieval.result.provenance.source_urlanyOf 1 / anyOf 1 / anyOf 2nullمطلوب في العنصر الأب—
retrieval.result.provenance.retrieved_atanyOf 1 / anyOf 1stringمطلوب في العنصر الأب
  • format: "date-time"
  • pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
retrieval.result.provenance.mime_typeanyOf 1 / anyOf 1string | nullمطلوب في العنصر الأب—
retrieval.result.provenance.mime_typeanyOf 1 / anyOf 1 / anyOf 1stringمطلوب في العنصر الأب
  • enum: ["text/html","application/xhtml+xml","text/plain","text/vtt","application/x-subrip","application/srt","text/srt"]
retrieval.result.provenance.mime_typeanyOf 1 / anyOf 1 / anyOf 2nullمطلوب في العنصر الأب—
retrieval.result.provenance.parser_versionanyOf 1 / anyOf 1stringمطلوب في العنصر الأب
  • const: "research-public-retrieval/v1"
retrieval.result.provenance.content_kindanyOf 1 / anyOf 1stringمطلوب في العنصر الأب
  • enum: ["document_text","metadata_only","published_caption_file","none"]
retrieval.result.provenance.caption_formatanyOf 1 / anyOf 1string | nullمطلوب في العنصر الأب—
retrieval.result.provenance.caption_formatanyOf 1 / anyOf 1 / anyOf 1stringمطلوب في العنصر الأب
  • enum: ["webvtt","subrip"]
retrieval.result.provenance.caption_formatanyOf 1 / anyOf 1 / anyOf 2nullمطلوب في العنصر الأب—
retrieval.result.provenance.languageanyOf 1 / anyOf 1string | nullمطلوب في العنصر الأب—
retrieval.result.provenance.languageanyOf 1 / anyOf 1 / anyOf 1stringمطلوب في العنصر الأب
  • minLength: 1
  • maxLength: 35
  • pattern: "^[a-zA-Z]{2,8}(?:-[a-zA-Z0-9]{1,8})*$"
retrieval.result.provenance.languageanyOf 1 / anyOf 1 / anyOf 2nullمطلوب في العنصر الأب—
retrieval.result.provenance.language_sourceanyOf 1 / anyOf 1stringمطلوب في العنصر الأب
  • enum: ["publisher_declared","unknown"]
retrieval.result.provenance.platform_native_verifiedanyOf 1 / anyOf 1booleanمطلوب في العنصر الأب
  • const: false
retrieval.result.reasonanyOf 1 / anyOf 1string | nullمطلوب في العنصر الأب—
retrieval.result.reasonanyOf 1 / anyOf 1 / anyOf 1stringمطلوب في العنصر الأب
  • enum: ["unsafe_url","unsupported_source","unsupported_media","unsupported_content","access_denied","login_required","no_text","metadata_only","no_captions","invalid_captions","not_found","rate_limited","response_too_large","text_limited","nodes_limited","cues_limited","invalid_cues","language_mismatch","source_partial","timeout","cancelled","egress_unavailable","unavailable"]
retrieval.result.reasonanyOf 1 / anyOf 1 / anyOf 2nullمطلوب في العنصر الأب—
retrieval.result.warningsanyOf 1 / anyOf 1arrayمطلوب في العنصر الأب
  • maxItems: 10
retrieval.result.warnings[]anyOf 1 / anyOf 1stringاختياري / عنصر
  • enum: ["unsafe_url","unsupported_source","unsupported_media","unsupported_content","access_denied","login_required","no_text","metadata_only","no_captions","invalid_captions","not_found","rate_limited","response_too_large","text_limited","nodes_limited","cues_limited","invalid_cues","language_mismatch","source_partial","timeout","cancelled","egress_unavailable","unavailable"]
retrieval.result.retry_after_secondsanyOf 1 / anyOf 1integer | nullمطلوب في العنصر الأب—
retrieval.result.retry_after_secondsanyOf 1 / anyOf 1 / anyOf 1integerمطلوب في العنصر الأب
  • minimum: 1
  • maximum: 86400
retrieval.result.retry_after_secondsanyOf 1 / anyOf 1 / anyOf 2nullمطلوب في العنصر الأب—
retrieval.resultanyOf 1 / anyOf 2nullمطلوب في العنصر الأب—
retrieval.evidenceanyOf 1object | nullمطلوب في العنصر الأب—
retrieval.evidenceanyOf 1 / anyOf 1objectمطلوب في العنصر الأب—
retrieval.evidence.evidence_idanyOf 1 / anyOf 1stringمطلوب في العنصر الأب
  • format: "uuid"
  • pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
retrieval.evidence.revisionanyOf 1 / anyOf 1integerمطلوب في العنصر الأب
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
retrieval.evidenceanyOf 1 / anyOf 2nullمطلوب في العنصر الأب—
retrievalanyOf 2nullمطلوب في العنصر الأب—
مخطط JSON Schema الكامل
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "retrieval": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "workspace_id": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "mutation_id": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "state": {
              "type": "string",
              "enum": [
                "pending",
                "running",
                "completed",
                "cancelled",
                "unconfirmed",
                "expired"
              ]
            },
            "kind": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "url_text",
                    "published_captions"
                  ]
                },
                {
                  "type": "null"
                }
              ]
            },
            "created_at": {
              "type": "string",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
              "format": "date-time"
            },
            "settled_at": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                  "format": "date-time"
                },
                {
                  "type": "null"
                }
              ]
            },
            "valid_until": {
              "type": "string",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
              "format": "date-time"
            },
            "result": {
              "anyOf": [
                {
                  "type": "object",
                  "properties": {
                    "kind": {
                      "type": "string",
                      "enum": [
                        "url_text",
                        "published_captions"
                      ]
                    },
                    "status": {
                      "type": "string",
                      "enum": [
                        "ready",
                        "partial",
                        "blocked",
                        "unsupported",
                        "empty",
                        "rate_limited",
                        "unavailable",
                        "cancelled"
                      ]
                    },
                    "text": {
                      "type": "string",
                      "maxLength": 20000
                    },
                    "title": {
                      "anyOf": [
                        {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "description": {
                      "anyOf": [
                        {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 2000
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "segments": {
                      "maxItems": 1000,
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "start_ms": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991
                          },
                          "end_ms": {
                            "type": "integer",
                            "exclusiveMinimum": 0,
                            "maximum": 9007199254740991
                          },
                          "text": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 20000
                          }
                        },
                        "required": [
                          "start_ms",
                          "end_ms",
                          "text"
                        ]
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "properties": {
                        "source_url": {
                          "anyOf": [
                            {
                              "type": "string",
                              "maxLength": 2048,
                              "format": "uri"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "retrieved_at": {
                          "type": "string",
                          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                          "format": "date-time"
                        },
                        "mime_type": {
                          "anyOf": [
                            {
                              "type": "string",
                              "enum": [
                                "text/html",
                                "application/xhtml+xml",
                                "text/plain",
                                "text/vtt",
                                "application/x-subrip",
                                "application/srt",
                                "text/srt"
                              ]
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "parser_version": {
                          "type": "string",
                          "const": "research-public-retrieval/v1"
                        },
                        "content_kind": {
                          "type": "string",
                          "enum": [
                            "document_text",
                            "metadata_only",
                            "published_caption_file",
                            "none"
                          ]
                        },
                        "caption_format": {
                          "anyOf": [
                            {
                              "type": "string",
                              "enum": [
                                "webvtt",
                                "subrip"
                              ]
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "language": {
                          "anyOf": [
                            {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 35,
                              "pattern": "^[a-zA-Z]{2,8}(?:-[a-zA-Z0-9]{1,8})*$"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "language_source": {
                          "type": "string",
                          "enum": [
                            "publisher_declared",
                            "unknown"
                          ]
                        },
                        "platform_native_verified": {
                          "type": "boolean",
                          "const": false
                        }
                      },
                      "required": [
                        "source_url",
                        "retrieved_at",
                        "mime_type",
                        "parser_version",
                        "content_kind",
                        "caption_format",
                        "language",
                        "language_source",
                        "platform_native_verified"
                      ]
                    },
                    "reason": {
                      "anyOf": [
                        {
                          "type": "string",
                          "enum": [
                            "unsafe_url",
                            "unsupported_source",
                            "unsupported_media",
                            "unsupported_content",
                            "access_denied",
                            "login_required",
                            "no_text",
                            "metadata_only",
                            "no_captions",
                            "invalid_captions",
                            "not_found",
                            "rate_limited",
                            "response_too_large",
                            "text_limited",
                            "nodes_limited",
                            "cues_limited",
                            "invalid_cues",
                            "language_mismatch",
                            "source_partial",
                            "timeout",
                            "cancelled",
                            "egress_unavailable",
                            "unavailable"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "warnings": {
                      "maxItems": 10,
                      "type": "array",
                      "items": {
                        "type": "string",
                        "enum": [
                          "unsafe_url",
                          "unsupported_source",
                          "unsupported_media",
                          "unsupported_content",
                          "access_denied",
                          "login_required",
                          "no_text",
                          "metadata_only",
                          "no_captions",
                          "invalid_captions",
                          "not_found",
                          "rate_limited",
                          "response_too_large",
                          "text_limited",
                          "nodes_limited",
                          "cues_limited",
                          "invalid_cues",
                          "language_mismatch",
                          "source_partial",
                          "timeout",
                          "cancelled",
                          "egress_unavailable",
                          "unavailable"
                        ]
                      }
                    },
                    "retry_after_seconds": {
                      "anyOf": [
                        {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 86400
                        },
                        {
                          "type": "null"
                        }
                      ]
                    }
                  },
                  "required": [
                    "kind",
                    "status",
                    "text",
                    "title",
                    "description",
                    "segments",
                    "provenance",
                    "reason",
                    "warnings",
                    "retry_after_seconds"
                  ]
                },
                {
                  "type": "null"
                }
              ]
            },
            "evidence": {
              "anyOf": [
                {
                  "type": "object",
                  "properties": {
                    "evidence_id": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                    },
                    "revision": {
                      "type": "integer",
                      "exclusiveMinimum": 0,
                      "maximum": 9007199254740991
                    }
                  },
                  "required": [
                    "evidence_id",
                    "revision"
                  ]
                },
                {
                  "type": "null"
                }
              ]
            }
          },
          "required": [
            "id",
            "workspace_id",
            "mutation_id",
            "state",
            "kind",
            "created_at",
            "settled_at",
            "valid_until",
            "result",
            "evidence"
          ]
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "retrieval"
  ]
}

الأخطاء وإعادة المحاولة بأمان

افحص حالة HTTP والجسم. قد يحوي خطأ التحقق 400 ‏ZodError؛ تستخدم أخطاء المعالج error و message و code. احتفظ بـ request_id أو x-request-id للتشخيص دون اعتماد. أصلح أخطاء وصول 401/403 قبل المحاولة واتّبع Retry-After لـ 429. لكتابة غير مؤكدة أو 5xx، اقرأ الموجود أولاً. أعِد مفتاح منع التكرار حيث يُدعم فقط؛ تختلف المحاولة حسب العملية ولا تضمن التسليم مرة واحدة بالضبط.

دليل استكشاف الأخطاء وإصلاحها

أمثلة

تستخدم الأمثلة قيماً خيالية مفحوصة بالمخططات. استبدل المعرّفات بالمفوّض لك، والوسائط بأصول جاهزة، والتواريخ بوقت نشر مؤكد. افحص أهلية الحساب قبل الكتابة. لا تُرسل الصفحة طلبات API.

اضبط SOSOAPI_ACCESS_TOKEN على خادمك ببيانات اعتماد تقبلها العملية، وأبقِه خارج شيفرة المتصفح. لوكيل الذكاء الاصطناعي، استخدم sosoapi auth login للدخول بالمتصفح ودع CLI يحدّث بيانات اعتماده.

request.json

{
  "workspace_id": "11111111-1111-4111-8111-111111111111",
  "mutation_id": "40000000-0000-4000-8000-000000000001"
}

cURL

curl --request POST \
  "https://gqeshlawtcexsapabaui.supabase.co/functions/v1/research-api/evidence/status" \
  -H "Authorization: Bearer $SOSOAPI_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  --data-binary @request.json

JavaScript

// Server-side JavaScript. Do not print tokens or credential-bearing responses.
const token = process.env.SOSOAPI_ACCESS_TOKEN;
if (!token) throw new Error("Set an accepted credential for this operation");
const response = await fetch("https://gqeshlawtcexsapabaui.supabase.co/functions/v1/research-api/evidence/status", {
  method: "POST",
  headers: { "Content-Type": "application/json", Authorization: "Bearer " + token },
  body: JSON.stringify({
  "workspace_id": "11111111-1111-4111-8111-111111111111",
  "mutation_id": "40000000-0000-4000-8000-000000000001"
})
});
const result = await response.json();
// Check response.ok, the operation-specific body and completion state before continuing.

CLI

npx sosoapi api post /research-api/evidence/status < request.json

مثال استجابة اصطناعية

{
  "retrieval": {
    "id": "30000000-0000-4000-8000-000000000007",
    "workspace_id": "11111111-1111-4111-8111-111111111111",
    "mutation_id": "40000000-0000-4000-8000-000000000001",
    "state": "completed",
    "kind": "url_text",
    "created_at": "2099-01-15T09:00:00Z",
    "settled_at": "2099-01-15T09:00:01Z",
    "valid_until": "2099-01-16T09:00:00Z",
    "evidence": null,
    "result": {
      "kind": "url_text",
      "status": "unavailable",
      "text": "",
      "title": null,
      "description": null,
      "segments": [],
      "provenance": {
        "source_url": null,
        "retrieved_at": "2099-01-15T09:00:01Z",
        "mime_type": null,
        "parser_version": "research-public-retrieval/v1",
        "content_kind": "none",
        "caption_format": null,
        "language": null,
        "language_source": "unknown",
        "platform_native_verified": false
      },
      "reason": "unavailable",
      "warnings": [],
      "retry_after_seconds": null
    }
  }
}

MCP: sosoapi_research_evidence_status