All Products
Search

This Product

    Seri Qoder CN:Dapatkan sesi QR channel

    Document Center

    Seri Qoder CN:Dapatkan sesi QR channel

    Last Updated:Jul 04, 2026

    Lakukan polling terhadap sesi otorisasi QR Channel.

    Header permintaan

    Header

    Wajib

    Deskripsi

    Authorization

    Ya

    Bearer <PAT>

    Parameter path

    Parameter

    Tipe

    Wajib

    Deskripsi

    session_key

    string

    Ya

    Kunci sesi QR opaque yang dikembalikan oleh Create Channel QR Session.

    Contoh permintaan

    curl -s -X GET 'https://api.qoder.com.cn/api/v1/forward/qr_sessions/qr-a1b2c3d4' \
  -H "Authorization: Bearer $QODER_PAT"

    Contoh respons

    HTTP 200 OK

    {
  "type": "channel_qr_session",
  "session_key": "qr-a1b2c3d4",
  "channel_id": "ci_dingtalk_001",
  "channel_type": "dingtalk",
  "status": "confirmed",
  "expires_at": "2026-06-18T10:05:00Z",
  "err_code": null,
  "err_msg": null
}

    Nilai status

    Status

    Deskripsi

    waiting

    Menunggu pemindaian, otorisasi, instalasi, atau konfigurasi.

    scanned

    Kode QR telah dipindai dan menunggu konfirmasi dari perangkat seluler.

    confirmed

    Aktivasi berhasil. binding_status Channel menjadi bound.

    expired

    Sesi QR telah kedaluwarsa. Buat sesi QR baru.

    denied

    Pengguna menolak otorisasi atau membatalkan instalasi.

    error

    Gateway atau channel pihak ketiga mengembalikan error yang tidak dapat dipulihkan.

    Kesalahan

    HTTP

    Tipe

    Kode

    Pemicu

    401

    authentication_error

    authentication_required

    PAT tidak valid atau telah kedaluwarsa.

    404

    not_found_error

    channel_qr_session_not_found

    Sesi QR tidak ada, telah kedaluwarsa, atau tidak terlihat oleh pemanggil.

    Catatan

    • session_key adalah token opaque berentropi tinggi dengan masa berlaku singkat.

    • Lakukan polling sesuai dengan interval poll_interval_seconds yang dikembalikan dalam respons pembuatan.

    • Setelah status menjadi confirmed, perbarui detail Channel.