Yönetim

API Anahtarını Güncelle

Geçerli kuruluş için mevcut bir kullanıcı API anahtarını günceller.

PATCHhttps://api.tokenlab.sh/v1/management/api-keys/{keyId}

Genel Bakış

Mevcut bir kullanıcı API anahtarının adını, kullanım limitini, izinli modellerini, son kullanma süresini veya durumunu güncellemek için bu endpoint'i kullanın.

İstek Gövdesi

En az bir alan verilmelidir.

AlanTürVarsayılan / SınırlarNotlar
statusenum-active, inactive, revoked
namestringuzunluk 1-50Güncellenmiş görünen ad
limitAmountnumber | string | null0–100000 USDnull sınırsız anlamına gelir; 0 harcamayı engeller. Ondalık dizeler en fazla 6 ondalık basamak destekler.
limitCurrencyenumvarsayılan USDYalnızca USD. CNY gönderildiğinde 400 currency_retired döner. Belirtilirse limitAmount da gereklidir.
modelsstring[]-Güncellenmiş model allowlist'i
deliveryPolicystring | nullauto, verified, official, nullnull, çalışma alanının teslim politikasını devralır.
expiresAtstring | nullRFC3339 datetimenull son kullanmayı kaldırır

Notlar

  • Parasal alanlar yalnızca USD’yi destekler. CNY girişleri kullanımdan kaldırılmıştır ve 400 currency_retired döndürür.

  • Hard delete, Management API v1'de kasıtlı olarak desteklenmez.

  • revoked, normal operasyonel kullanım için terminal bir durumdur; gelecekte bir un-revoke akışı beklemek yerine yeni bir anahtar oluşturun.

Örnek

İstek

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

İstek / Yanıt

Bu sayfa OpenAPI şemasını ve kopyalanabilir istek örneklerini sunar. Yönetim isteklerini Management Token kullanarak terminalinizden veya istemcinizden gönderin; bu sayfadan doğrudan gönderim yapılamaz.

Yanıt örneği

Yanıt

200 OK
{
  "id": "key_abc123def456",
  "name": "Backend Worker",
  "key_prefix": "sk-live...",
  "status": "inactive",
  "limit_amount": 0,
  "limit_amount_decimal": "0",
  "used_amount": 148.25,
  "used_amount_decimal": "148.25",
  "models": [
    "gpt-5.6-luna",
    "claude-3-7-sonnet"
  ],
  "expires_at": "2026-12-31T23:59:59.000Z",
  "last_used_at": "2026-07-08T03:12:45.000Z",
  "created_at": "2026-07-01T10:00:00.000Z",
  "delivery_policy": null
}

Önemli alanlar

idstring
Sonraki Yönetim API’si çağrılarında kullanılan API anahtarı tanımlayıcısı.
namestring
API anahtarının görünen adı.
key_prefixstring
Görüntüleme ve destek için gizli olmayan anahtar öneki.
statusstring
active, inactive, suspended veya revoked değerlerinden biri.
limit_amountnumber | null
Görüntüleme için JSON sayısı olarak USD harcama limiti. null sınırsız anlamına gelir.
limit_amount_decimalstring | null
Ondalık dize olarak kesin USD harcama limiti. null sınırsız anlamına gelir.
used_amountnumber
Görüntüleme için JSON sayısı olarak USD cinsinden birikmiş kullanım harcaması.
used_amount_decimalstring
Ondalık dize olarak USD cinsinden kesin birikmiş kullanım harcaması.
modelsstring[]
Anahtar başına izin verilen model listesi. Boş dizi, anahtar düzeyinde ek model kısıtlaması olmadığı anlamına gelir.
delivery_policystring | null
auto, verified, official, null. null, çalışma alanının teslim politikasını devralır.
expires_atstring | null
Anahtarın süresinin dolduğu ISO zaman damgası veya süre sonu yoksa null.
last_used_atstring | null
En son kullanımın ISO zaman damgası veya hiç kullanılmadıysa null.
created_atstring
Oluşturma ISO zaman damgası.

Yetkilendirme

ManagementTokenAuth
AuthorizationBearer <token>

Yönetim belirteci kimlik doğrulaması. Yönetim Belirteçlerini Dashboard > API > Management Tokens bölümünden oluşturun veya yönetin.

Konum: header

Yol parametreleri

keyId*string

İstek gövdesi

application/json

En az bir alan sağlanmalıdır.

Özellikler1 <= properties

Yanıt

application/json

application/json

application/json

application/json

application/json

application/json