All Products
Search

This Product

    Seri Qoder CN:Daftar sesi

    Document Center

    Seri Qoder CN:Daftar sesi

    Last Updated:Jul 04, 2026

    Daftarkan sesi Forward menggunakan filter dan paginasi kursor.

    Header permintaan

    Header

    Wajib

    Deskripsi

    Authorization

    Ya

    Bearer <PAT>

    Parameter kueri

    Parameter

    Tipe

    Wajib

    Bawaan

    Deskripsi

    identity_ids

    string atau array

    Tidak

    -

    Filter berdasarkan satu atau beberapa Identity ID. String yang dipisahkan koma didukung.

    template_id

    string

    Tidak

    -

    Filter berdasarkan ID Templat Forward.

    source_type

    string

    Tidak

    -

    Filter berdasarkan api, im, atau schedule.

    created_at[gt]

    string

    Tidak

    -

    Dibuat secara eksklusif setelah timestamp RFC 3339 ini.

    created_at[gte]

    string

    Tidak

    -

    Dibuat pada atau setelah timestamp RFC 3339 ini.

    created_at[lt]

    string

    Tidak

    -

    Dibuat secara eksklusif sebelum timestamp RFC 3339 ini.

    created_at[lte]

    string

    Tidak

    -

    Dibuat pada atau sebelum timestamp RFC 3339 ini.

    updated_at[gt]

    string

    Tidak

    -

    Diperbarui secara eksklusif setelah timestamp RFC 3339 ini.

    updated_at[gte]

    string

    Tidak

    -

    Diperbarui pada atau setelah timestamp RFC 3339 ini.

    updated_at[lt]

    string

    Tidak

    -

    Diperbarui secara eksklusif sebelum timestamp RFC 3339 ini.

    updated_at[lte]

    string

    Tidak

    -

    Diperbarui pada atau sebelum timestamp RFC 3339 ini.

    limit

    integer

    Tidak

    20

    Jumlah item per halaman. Maksimum 100.

    after_id

    string

    Tidak

    -

    Kursor untuk catatan setelah Session ID yang diberikan. Tidak dapat digunakan bersama before_id.

    before_id

    string

    Tidak

    -

    Kursor untuk catatan sebelum Session ID yang diberikan. Tidak dapat digunakan bersama after_id.

    order

    string

    Tidak

    desc

    Urutan pengurutan: desc atau asc.

    include_archived

    boolean

    Tidak

    false

    Sertakan sesi yang diarsipkan.

    Contoh permintaan

    curl -s -X GET 'https://api.qoder.com.cn/api/v1/forward/sessions?identity_ids=idn_xxx,idn_yyy&template_id=tmpl_support&source_type=im&created_at[gte]=2026-06-01T00:00:00Z&limit=20' \
  -H "Authorization: Bearer $QODER_PAT"

    Contoh tanggapan

    HTTP 200 OK

    {
  "data": [
    {
      "id": "sess_xxx",
      "type": "session",
      "identity_id": "idn_xxx",
      "template": {
        "id": "tmpl_support",
        "type": "template",
        "name": "Support assistant",
        "model": "ultimate",
        "version": 3
      },
      "source_type": "im",
      "status": "idle",
      "title": "Customer support session",
      "incremental_streaming_enabled": true,
      "metadata": {
        "source": "dingtalk"
      },
      "config": {
        "environment_variables": {
          "API_KEY": "sk-xxx"
        }
      },
      "stats": {
        "active_seconds": 30,
        "duration_seconds": 3600
      },
      "usage": {
        "credits": 12.5
      },
      "archived_at": null,
      "created_at": "2026-06-22T10:00:00Z",
      "updated_at": "2026-06-22T11:00:00Z"
    }
  ],
  "first_id": "sess_xxx",
  "last_id": "sess_xxx",
  "has_more": false
}

    Bidang tanggapan

    Bidang

    Tipe

    Deskripsi

    data

    array

    Objek session pada halaman saat ini.

    first_id

    string|null

    ID catatan pertama pada halaman ini.

    last_id

    string|null

    ID catatan terakhir pada halaman ini.

    has_more

    boolean

    Apakah masih ada catatan tambahan.

    Kesalahan

    HTTP

    Tipe

    Kode

    Pemicu

    400

    invalid_request_error

    invalid_time_range

    Filter waktu tidak valid.

    400

    invalid_request_error

    invalid_pagination

    Parameter paginasi tidak valid.

    401

    authentication_error

    authentication_required

    PAT tidak valid atau kedaluwarsa.

    Catatan

    • after_id dan before_id tidak dapat digunakan secara bersamaan.

    • Desain saat ini tidak mendukung pemfilteran berdasarkan status.

    • usage.credits mungkin dihilangkan jika modul credits tidak diaktifkan.