الملفات والدفعات
سرد دفعات الرسائل
سرد دفعات الرسائل التي أنشأتها مؤسستك.
نظرة عامة
إرجاع دفعات الرسائل التي أنشأتها مؤسستك من خلال هذا الـ API، مرتبة من الأحدث إلى الأقدم. تعرض القائمة الحالة التي سجلتها TokenLab مؤخراً لكل دفعة. للتحقق من دفعة واحدة الآن، استرجعها.
ملاحظات
limitتتراوح من 1 إلى 1000 والقيمة الافتراضية هي 20.- للتنقل بين الصفحات، مرر
after_id(للدفعات الأقدم) أوbefore_id(للدفعات الأحدث) مع معرف دفعة من القائمة. لا ترسل كليهما. تُرجع TokenLab رمز الخطأ400في حال وجود معرف غير معروف أو أي معامل استعلام آخر. - الدفعات المحذوفة لا تظهر في القائمة.
- تكون قيمة
has_moreهيtrueعند وجود المزيد من الدفعات.
الطلب
curl -X GET "https://api.tokenlab.sh/v1/messages/batches?limit=20" \
-H "x-api-key: sk-your-api-key" \
-H "anthropic-version: 2023-06-01"الاستجابة
{
"data": [
{
"id": "msgbatch_01ABC123",
"type": "message_batch",
"processing_status": "ended",
"request_counts": { "processing": 0, "succeeded": 2, "errored": 0, "canceled": 0, "expired": 0 },
"ended_at": "2026-11-01T10:20:00Z",
"created_at": "2026-11-01T10:00:00Z",
"expires_at": "2026-11-02T10:00:00Z",
"cancel_initiated_at": null,
"archived_at": null,
"results_url": "https://api.tokenlab.sh/v1/messages/batches/msgbatch_01ABC123/results"
}
],
"first_id": "msgbatch_01ABC123",
"last_id": "msgbatch_01ABC123",
"has_more": false
}حقول هامة
dataarray
دفعات الرسائل، مرتبة من الأحدث إلى الأقدم.
first_idstring|null
معرف الدفعة الأولى في
data.last_idstring|null
معرف الدفعة الأخيرة في
data.has_moreboolean
تتوفر المزيد من الدفعات عندما تكون قيمة
has_more هي true.التفويض
BearerAuth AuthorizationBearer <token>
مصادقة مفتاح API. قم بإنشاء أو إدارة مفاتيح API في Dashboard > API > API Keys.
الموضع: header
معاملات الاستعلام
before_id?string
إرجاع الدفعات قبل معرف الدفعة هذا. لا يمكن دمجه مع after_id.
after_id?string
إرجاع الدفعات بعد معرف الدفعة هذا. لا يمكن دمجه مع before_id.
limit?integer
الحد الأقصى لعدد الدفعات المراد إرجاعها
النطاق
1 <= value <= 1000الافتراضي
20الاستجابة
application/json
application/json
application/json
application/json
application/json
application/json
application/json