All Products
Search

This Product

    Seri Qoder CN:Buat sesi QR channel

    Document Center

    Seri Qoder CN:Buat sesi QR channel

    Last Updated:Jul 04, 2026

    Buat sesi otorisasi QR berumur pendek untuk suatu channel.

    Header permintaan

    Header

    Wajib

    Deskripsi

    Authorization

    Ya

    Bearer <PAT>

    Content-Type

    Tidak

    application/json jika badan permintaan dikirim.

    Idempotency-Key

    Tidak

    Kunci idempotensi opsional untuk permintaan yang tidak aman.

    Parameter path

    Parameter

    Tipe

    Wajib

    Deskripsi

    channel_id

    string

    Ya

    ID Channel.

    Contoh permintaan

    curl -s -X POST 'https://api.qoder.com.cn/api/v1/forward/channels/ci_dingtalk_001/qr_sessions' \
  -H "Authorization: Bearer $QODER_PAT" \
  -H "Content-Type: application/json" \
  -d '{}'

    Contoh respons

    HTTP 200 OK

    {
  "type": "channel_qr_session",
  "session_key": "qr-a1b2c3d4",
  "channel_id": "ci_dingtalk_001",
  "channel_type": "dingtalk",
  "status": "waiting",
  "qr_code_content": "https://login.dingtalk.com/oauth2/...",
  "qr_code_image_base64": "data:image/png;base64,...",
  "expires_at": "2026-06-18T10:05:00Z",
  "poll_interval_seconds": 3
}

    Bidang respons

    Bidang

    Tipe

    Deskripsi

    type

    string

    Selalu channel_qr_session.

    session_key

    string

    Kunci sesi QR opaque yang digunakan untuk polling.

    channel_id

    string

    ID Channel terkait.

    channel_type

    string

    wechat, feishu, dingtalk, atau wecom.

    status

    string

    Status awal, biasanya waiting.

    qr_code_content

    string

    Konten QR asli, biasanya berupa URL otorisasi pihak ketiga.

    qr_code_image_base64

    string

    Gambar QR yang dihasilkan oleh Gateway.

    expires_at

    string

    Timestamp kedaluwarsa.

    poll_interval_seconds

    integer

    Interval polling yang direkomendasikan.

    Kesalahan

    HTTP

    Tipe

    Kode

    Pemicu

    400

    invalid_request_error

    channel_type_unsupported

    Tipe Channel tidak mendukung sesi QR.

    404

    not_found_error

    channel_not_found

    Channel tidak ditemukan.

    409

    conflict_error

    channel_disabled

    Channel dinonaktifkan.

    502

    api_error

    channel_auth_failed

    Otorisasi Gateway atau pihak ketiga gagal.

    Catatan

    • Sesi QR P0 mendukung wechat, feishu, dingtalk, dan wecom.

    • qq tidak mendukung sesi QR terpadu di P0.

    • Badan permintaan dapat dihilangkan atau berupa {}.