All Products
Search
Document Center

Seri Qoder CN:Daftar jadwal

Last Updated:Jul 04, 2026

Daftarkan jadwal Forward untuk suatu Identity menggunakan pagination kursor.

Header permintaan

Header

Wajib

Deskripsi

Authorization

Ya

Bearer <PAT>

Parameter kueri

Parameter

Tipe

Wajib

Bawaan

Deskripsi

identity_id

string

Ya

ID Forward Identity yang memiliki Schedule tersebut.

template_id

string

Tidak

-

Filter berdasarkan ID Forward Template.

status

string

Tidak

-

Filter berdasarkan active atau paused.

include_archived

boolean

Tidak

false

Sertakan jadwal yang diarsipkan.

limit

integer

Tidak

20

Jumlah item per halaman. Maksimum 100.

after_id

string

Tidak

-

Kursor untuk catatan setelah ID Schedule yang diberikan.

before_id

string

Tidak

-

Kursor untuk catatan sebelum ID Schedule yang diberikan.

Contoh permintaan

curl -s -X GET 'https://api.qoder.com.cn/api/v1/forward/schedules?identity_id=idn_019eabc123&limit=20' \
  -H "Authorization: Bearer $QODER_PAT"

Contoh respons

HTTP 200 OK

{
  "data": [
    {
      "id": "sched_019f00112233445566778899aabbccdd",
      "identity_id": "idn_019eabc123",
      "template_id": "tmpl_support",
      "name": "Daily tech brief",
      "description": "Generate a daily technology news summary",
      "status": "active",
      "paused_reason": null,
      "initial_events": [
        {
          "type": "user.message",
          "content": "Summarize current technology news in five bullet points."
        }
      ],
      "execution": {
        "session_mode": "new_session",
        "max_concurrent_runs": 1,
        "max_attempts": 1,
        "timeout_ms": 300000
      },
      "trigger_policy": {
        "type": "cron",
        "expression": "0 9 * * *",
        "timezone": "Asia/Shanghai",
        "upcoming_runs_at": ["2026-06-23T01:00:00Z"]
      },
      "environment_id": "env_019e64e01a137caf953ac2ac7b42ec5c",
      "sinks": [],
      "metadata": {},
      "archived_at": null,
      "created_at": "2026-06-22T10:00:00Z",
      "updated_at": "2026-06-22T10:00:00Z"
    }
  ],
  "first_id": "sched_019f00112233445566778899aabbccdd",
  "last_id": "sched_019f00112233445566778899aabbccdd",
  "has_more": false
}

Bidang respons

Bidang

Tipe

Deskripsi

data

array

Objek Schedule lengkap 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

Menunjukkan apakah masih ada catatan tambahan.

Kesalahan

HTTP

Tipe

Kode

Pemicu

400

invalid_request_error

invalid_identity

identity_id tidak ada atau tidak valid.

400

invalid_request_error

invalid_pagination

Parameter pagination tidak valid.

401

authentication_error

authentication_required

PAT tidak valid atau telah kedaluwarsa.

Catatan

  • Hasil dikembalikan dalam urutan menurun berdasarkan waktu pembuatan.

  • Catatan yang diarsipkan hanya dikembalikan jika include_archived=true.