Langsung ke konten utama

Ikhtisar

Gunakan endpoint ini untuk memperbarui nama, batas penggunaan, model yang diizinkan, waktu kedaluwarsa, atau status dari API key yang sudah ada.

Request body

Request PATCH harus menyertakan minimal satu field.
FieldTipeDefault / batasDeskripsi
statusenum-active, inactive, revoked
namestringpanjang 1-50Nama tampilan yang diperbarui
limitAmountnumber | nullminimum 0, maksimum 100000null = tanpa batas, 0 = kuota nol, nilai positif = batas USD
limitCurrencyenumdefault USDOpsional: USD atau CNY. Jika diatur ke CNY, limitAmount diperlakukan sebagai RMB dan dikonversi ke USD di server sebelum disimpan
modelsstring[]-Allowlist model logis yang diperbarui
expiresAtstring | nulldatetime RFC3339null menghapus tanggal kedaluwarsa

Catatan

  • Penghapusan permanen memang tidak didukung di Management API v1.
  • revoked biasanya dianggap sebagai status terminal; jika Anda membutuhkan key lagi, biasanya lebih baik membuat key baru.
  • Secara default, limitAmount ditafsirkan sebagai USD. Jika Anda mengirim limitCurrency: "CNY", batas tersebut diperlakukan sebagai RMB dan otomatis dikonversi ke USD dengan kurs saat ini sebelum disimpan.
  • Respons menyertakan exchange_rate serta field tampilan RMB limit_amount_cny dan used_amount_cny.

Contoh

curl -X PATCH "https://api.lemondata.cc/v1/management/api-keys/key_abc123def456" \
  -H "Authorization: Bearer mt-your-management-token" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "inactive",
    "limitAmount": 0
  }'

Request / Respons

Gunakan panel OpenAPI interaktif di atas untuk melihat schema dan field respons yang tepat.