النص

حذف استجابة

حذف استجابة مخزنة. لا يؤدي هذا الإجراء إلى إلغاء عملية التوليد.

DELETE
/v1/responses/{id}

نظرة عامة

حذف استجابة مخزنة باستخدام المعرف (ID). بعد الحذف، لا يمكن استرجاع المعرف أو استخدامه كـ previous_response_id.

هذا الإجراء هو حذف وليس إلغاء: فهو لا يوقف استجابة لا تزال قيد التشغيل. يمكنك فقط حذف الاستجابات التي تم إنشاؤها في حسابك الخاص. المعرف غير المعروف، أو المعرف الخاص بحساب آخر، أو المعرف الذي قمت بحذفه مسبقاً، جميعها تعيد رمز الخطأ 404.

مثال

الطلب

cURL
curl -X DELETE "https://api.tokenlab.sh/v1/responses/resp_abc123" \
  -H "Authorization: Bearer sk-your-api-key"

مثال على الاستجابة

الاستجابة

200 OK
{
  "id": "resp_abc123",
  "object": "response.deleted",
  "deleted": true
}
deletedboolean
تكون true عند حذف الاستجابة. تحقق من هذا الحقل: قد تختلف قيمة object باختلاف النموذج.

الأخطاء

الحالةالرمزالمعنى
404response_not_foundالمعرف غير معروف، أو ينتمي لحساب آخر، أو تم حذفه مسبقاً.
502upstream_delete_failedلم يتمكن TokenLab من حذف الاستجابة في الخدمة التي أنتجتها. لا تزال الاستجابة مخزنة. حاول مرة أخرى لاحقاً.
503upstream_delete_recovery_pendingعملية الحذف قيد التسوية. لا تقم بإرسال الطلب مرة أخرى على الفور.
503response_state_unavailableحالة الاستجابة غير متاحة مؤقتاً. حاول مرة أخرى لاحقاً.

التفويض

BearerAuth
AuthorizationBearer <token>

مصادقة مفتاح API. قم بإنشاء أو إدارة مفاتيح API في Dashboard > API > API Keys.

الموضع: header

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

id*string

معرف الاستجابة الذي تم إرجاعه بواسطة POST /v1/responses.

الاستجابة

application/json

application/json

application/json

application/json