Comvo API

يلزم JavaScript لعرض التوثيق. التعريف القابل للقراءة آليًا: OpenAPI (JSON).

رموز الأخطاء

الرمز	الحالة	المعنى
`unauthenticated`	401	ترويسة Authorization مفقودة أو تنسيقها خاطئ.
`invalid_key`	401	المفتاح غير موجود أو أُلغي أو انتهت صلاحيته. أنشئ مفتاحًا جديدًا من اللوحة.
`insufficient_scope`	403	لا يملك المفتاح النطاق اللازم لهذه العملية (مذكور في الحقل required_scope). أنشئ المفتاح بالنطاق الجديد.
`outside_scope`	403	المفتاح المقيد بوحدة لا يمكنه الوصول إلى هذا السجل أو إلى عملية على مستوى المستأجر بالكامل.
`forbidden`	403	العملية غير مسموح بها.
`not_found`	404	السجل غير موجود أو خارج نطاق وصول المفتاح (الوحدة، الوضع الفعلي/الاختبار).
`method_not_allowed`	405	هذا العنوان لا يدعم طريقة HTTP هذه.
`invitation_completed`	409	لا يمكن إلغاء دعوة تم الرد عليها.
`idempotency_in_progress`	409	الطلب الأول بنفس Idempotency-Key ما زال قيد المعالجة؛ أعد المحاولة بعد قليل.
`invalid_idempotency_key`	400	Idempotency-Key فارغ أو أطول من 255 حرفًا.
`idempotency_mismatch`	422	استُخدم Idempotency-Key نفسه مع محتوى مختلف.
`validation_failed`	422	توجد أخطاء في البيانات المرسلة؛ التفاصيل لكل حقل في errors.
`survey_not_live`	422	الاستبيان غير منشور؛ لا يمكن فتح دعوة.
`unknown_context_field`	422	حقل في السياق غير معرّف في اللوحة ضمن KVKK ve Veri > Alanlar (KVKK والبيانات > الحقول؛ KVKK هو قانون حماية البيانات الشخصية في تركيا رقم 6698) (fields).
`privacy_notice_not_covering`	422	الحقول غير مذكورة في إشعار الخصوصية الساري للعلامة التجارية (fields). أضفها إلى الإشعار ثم انشره.
`invalid_assignee`	422	العضو المراد إسناده غير موجود أو لا يملك صلاحية إدارة هذا الرد.
`invalid_level`	422	اسم المستوى غير موجود، أو لا يوجد مستوى معرّف تحت الوحدة الأم.
`range_too_long`	422	نطاق المقاييس 366 يومًا كحد أقصى.
`rate_limited`	429	تم تجاوز حد المعدل؛ انتظر المدة المحددة في Retry-After.
`server_error`	500	خطأ غير متوقع. يمكنك إعادة المحاولة بأمان باستخدام Idempotency-Key.