الملفات والدفعات

سرد دفعات الرسائل

سرد دفعات الرسائل التي أنشأتها مؤسستك.

GET
/v1/messages/batches

نظرة عامة

إرجاع دفعات الرسائل التي أنشأتها مؤسستك من خلال هذا الـ API، مرتبة من الأحدث إلى الأقدم. تعرض القائمة الحالة التي سجلتها TokenLab مؤخراً لكل دفعة. للتحقق من دفعة واحدة الآن، استرجعها.

ملاحظات

  • limit تتراوح من 1 إلى 1000 والقيمة الافتراضية هي 20.
  • للتنقل بين الصفحات، مرر after_id (للدفعات الأقدم) أو before_id (للدفعات الأحدث) مع معرف دفعة من القائمة. لا ترسل كليهما. تُرجع TokenLab رمز الخطأ 400 في حال وجود معرف غير معروف أو أي معامل استعلام آخر.
  • الدفعات المحذوفة لا تظهر في القائمة.
  • تكون قيمة has_more هي true عند وجود المزيد من الدفعات.

مثال

الطلب

cURL
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"

الاستجابة

200 OK
{
  "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