All Products
Search

This Product

    AI Coding Assistant Lingma:Ikhtisar API

    Document Center

    AI Coding Assistant Lingma:Ikhtisar API

    Last Updated:Jun 09, 2026

    API Qoder Cloud Agents CN menyediakan kemampuan manajemen penuh untuk AI Agent yang di-hosting di cloud, mencakup pembuatan Agent, konfigurasi lingkungan, manajemen session, streaming event, dan lainnya. Semua titik akhir mengikuti konvensi REST dan menggunakan JSON untuk permintaan maupun respons.

    Catatan API ini saat ini berada dalam status Beta. Beberapa fungsionalitas dapat berubah pada rilis mendatang.

    URL Gateway

    Lingkungan URL
    Production https://api.qoder.com.cn/api/v1/cloud

    Pemberian Versi

    API saat ini menggunakan versi v1. Semua titik akhir diverifikasi melalui awalan URL /v1/ — tidak diperlukan header versi tambahan.

    API yang Tersedia

    Resource Deskripsi Base path
    Agents Operasi CRUD dan pengarsipan Agent /agents
    Environments Konfigurasi runtime environment /environments
    Sessions Pembuatan dan siklus hidup session Agen /sessions
    Events Bacaan dan dorong aliran acara sesi /events
    Files Unggah file dan asosiasinya /files
    Vaults Penyimpanan aman untuk kredensial sensitif /vaults
    Skills Pendaftaran dan manajemen skill Agent /skills
    Memory StoresPenyimpanan memori persisten/memory_stores

    Batas ukuran permintaan

    • Ukuran maksimum badan permintaan: 4 MB
    • Permintaan yang melebihi batas ini akan dipotong, menyebabkan Penguraian JSON gagal dengan 400 invalid_request_error (message: "Request body must be valid JSON.").

    Header Wajib

    Setiap permintaan API harus menyertakan Header otentikasi; Content-Type disarankan tetapi tidak wajib—server dapat mendeteksi secara otomatis:

    Authorization: Bearer $QODER_PAT
Content-Type: application/json  # direkomendasikan tetapi tidak wajib, server dapat mendeteksi secara otomatis

    Status Beta

    1. Permukaan API secara umum sudah stabil, tetapi tanda tangan (signatures) mungkin mengalami penyesuaian minor pada iterasi mendatang.
    2. Fungsionalitas baru dirilis di balik identifier beta baru.
    3. Kunci versi API dan tambahkan penanganan kompatibilitas saat Berjalan di lingkungan produksi.
    4. Semua fitur saat ini tersedia tanpa memerlukan Header Beta tambahan.

    Pemeriksaan Cepat Konektivitas

    # Mencantumkan Agen untuk akun saat ini (memverifikasi autentikasi dan konektivitas)
curl -s https://api.qoder.com.cn/api/v1/cloud/agents?limit=1 \
  -H "Authorization: Bearer $QODER_PAT"

    Tanggapan berhasil:

    {
  "data": [],
  "first_id": null,
  "last_id": null,
  "has_more": false
}

    Pembatasan Laju

    Lapisan aplikasi API saat ini tidak memiliki pembatasan laju yang aktif. Lapisan gerbang menerapkan penekanan lonjakan trafik global dan perlindungan DDoS, yang dapat mengembalikan kode respons 429 atau 503 ketika terpicu. Klien harus mengimplementasikan retry exponential backoff untuk respons 5xx/429 (1s → 2s → 4s, maksimal 3 kali percobaan).

    Langkah selanjutnya