메인 콘텐츠로 건너뛰기

​
개요

이 엔드포인트는 기존 API 키의 이름, 사용 한도, 허용 모델, 만료 시각, 상태를 업데이트할 때 사용합니다.

​
요청 본문

PATCH 요청에는 최소 1개 이상의 필드가 포함되어야 합니다.
필드타입기본값 / 제한설명
statusenum-active, inactive, revoked
namestring길이 1-50업데이트된 표시 이름
limitAmountnumber | null최소 0, 최대 100000null = 무제한, 0 = 사용 가능 한도 0, 양수 = USD 상한
limitCurrencyenum기본값 USD선택 사항: USD 또는 CNY. CNY로 설정하면 limitAmount를 RMB로 해석하고 저장 전에 서버에서 USD로 환산합니다
modelsstring[]-업데이트된 논리 모델 허용 목록
expiresAtstring | nullRFC3339 datetimenull 은 만료 제거

​
참고 사항

  • Management API v1 에서는 하드 삭제를 의도적으로 지원하지 않습니다.
  • revoked 는 일반적으로 종료 상태로 취급되므로, 다시 사용해야 한다면 새 키를 만드는 편이 낫습니다.
  • 기본적으로 limitAmount는 USD로 해석됩니다. limitCurrency: "CNY"를 보내면 한도가 RMB로 처리되고, 현재 환율로 자동 환산된 USD 값이 저장됩니다.
  • 응답에는 exchange_rate와 RMB 표시 필드인 limit_amount_cny, used_amount_cny가 함께 포함됩니다.

​
예시

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

​
요청 / 응답

정확한 스키마와 응답 필드는 상단의 인터랙티브 OpenAPI 패널을 참고하세요.