الانتقال إلى المحتوى الرئيسي
PATCH
curl
حدّث اسم القائمة أو وصفها. يتم تجاهل أي حقل آخر في نص الطلب، لذا تحتفظ list_type وentry_type بالقيم التي أُنشئت بها. لا يمكن تعديل قوائم النظام، وتُرجع 400. تحتوي الاستجابة على name وdescription فقط. لعرض القائمة الكاملة، استدعِ الحصول على القائمة.

التفويضات

x-api-key
string
header
مطلوب

مفتاح API الخاص بتطبيقك، من Developers -> API keys في Business Console. يمتلك المفتاح الأساسي وصولاً كاملاً. يمكن تحديد نطاق المفتاح المسمى: لا شيء، أو قراءة، أو كتابة لكل مورد، ومحدوداً ببعض مسارات العمل أو بالجلسات المقبولة، وبقائمة من عناوين IP، وبتاريخ انتهاء الصلاحية. يشير 401 إلى أن المفتاح غير صحيح أو ملغى أو منتهي الصلاحية؛ ويشير 403 إلى أنه لم يتم إرسال أي مفتاح، أو أن المفتاح ليس لديه حق الوصول إلى هذا المورد أو الإجراء، أو أن الطلب جاء من عنوان خارج قائمة عناوين IP الخاصة به؛ ويشير 404 في مسار جلسة إلى أن الجلسة خارج مسارات العمل أو الحالات الخاصة بالمفتاح. يتلقى المفتاح الذي لا يمتلك حق الوصول إلى الوسائط عناوين URL للصور ومقاطع الفيديو وملفات PDF كـ null، ويتلقى المفتاح الذي لا يمتلك إذن كتابة للجلسات روابط الجلسة وtoken كـ null. راجع https://docs.didit.me/console/api-keys.

معلمات المسار

list_uuid
string<uuid>
مطلوب

معرّف UUID للقائمة، كما تم إرجاعه بواسطة سرد القوائم أو إنشاء قائمة.

الجسم

application/json
name
string

الاسم الجديد. يجب أن يختلف عن اسم أي قائمة أخرى في التطبيق.

Required string length: 1 - 255
description
string

الوصف الجديد. أرسل سلسلة فارغة لمسحه.

الاستجابة

تم تحديث القائمة. يتم إرجاع الحقول القابلة للتعديل فقط.

name
string
مطلوب

اسم القائمة بعد التحديث.

description
string
مطلوب

وصف القائمة بعد التحديث.

آخر تعديل في ٧ نوفمبر ٢٠٢٦