Chuyển đến nội dung chính

​
Tổng quan

Dùng endpoint này để cập nhật tên, giới hạn sử dụng, danh sách model cho phép, thời gian hết hạn hoặc trạng thái của API key hiện có.

​
Phần thân yêu cầu

Yêu cầu PATCH phải có ít nhất một trường.
TrườngKiểuMặc định / giới hạnMô tả
statusenum-active, inactive, revoked
namestringđộ dài 1-50Tên hiển thị đã cập nhật
limitAmountnumber | nulltối thiểu 0, tối đa 100000null = không giới hạn, 0 = quota bằng 0, số dương = trần USD
limitCurrencyenummặc định USDTùy chọn: USD hoặc CNY. Khi đặt là CNY, limitAmount sẽ được hiểu là RMB và được server quy đổi sang USD trước khi lưu
modelsstring[]-Danh sách cho phép model logic đã cập nhật
expiresAtstring | nulldatetime RFC3339null sẽ xoá thời gian hết hạn

​
Lưu ý

  • Management API v1 cố ý không hỗ trợ hard delete.
  • revoked thường được xem là trạng thái cuối; nếu cần một key mới, thông thường nên tạo key khác.
  • Mặc định, limitAmount được hiểu theo USD. Nếu gửi limitCurrency: "CNY", hạn mức sẽ được hiểu theo RMB và tự động quy đổi sang USD theo tỷ giá hiện tại trước khi lưu.
  • Response sẽ kèm exchange_rate cùng các trường hiển thị RMB là limit_amount_cny và used_amount_cny.

​
Ví dụ

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
  }'

​
Yêu cầu / Phản hồi

Hãy dùng bảng OpenAPI tương tác phía trên để xem schema chính xác và các trường phản hồi.