Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Elenka u mmodifika ċ-ċwievet tiegħek

Lezzjoni 3 / 14 Aġġornat 29 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. Inventarju taċ-ċwievet API tiegħek
  2. Elenka ċ-ċwievet
  3. Immodifika ċavetta eżistenti
  4. Iċċekkja l-propagazzjoni
  5. Xenarji komuni
  6. Punti Ewlenin

Inventarju taċ-ċwievet API tiegħek

Maż-żmien, it-tim tiegħek jakkumula ċwievet API għal ambjenti, proġetti u membri tat-tim differenti. L-API tal-Ġestjoni (Management API) tippermettilek telenka ċ-ċwievet attivi kollha, tiffiltrahom skont il-permessi, u timmodifika l-konfigurazzjonijiet tagħhom mingħajr ma terġa’ toħloqhom.

Elenka ċ-ċwievet

Dan l-endpoint huwa l-punt tat-tluq għal kwalunkwe awditu tal-aċċess, u spiss huwa fejn tiskopri l-inventarju reali: ċwievet maħluqa għal test tmien xhur ilu, ċavetta f’isem membru tat-tim li telaq, żewġ ċwievet tal-produzzjoni li ħadd ma jaf liema qed tintuża. Iċċekkja l-lista qabel ma toħloq xi ħaġa ġdida—iċ-ċavetta li għandek bżonn tista’ diġà teżisti.

curl "https://management-api.x.ai/auth/teams/$TEAM_ID/api-keys" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Parametri tat-talba

  • pageSize: numru ta’ ċwievet għal kull paġna (b’mod default, jiġu rritornati ċ-ċwievet kollha)
  • paginationToken: token biex tirrikupra l-paġna li jmiss jekk in-numru ta’ ċwievet jaqbeż id-daqs tal-paġna
  • aclFilters: iffiltra ċ-ċwievet skont permessi speċifiċi

Iffiltra skont l-ACL

Tista’ tirrikupra biss ċ-ċwievet b’livell ta’ aċċess partikolari:

# Elenka biss iċ-ċwievet b'aċċess għaċ-chat
curl "https://management-api.x.ai/auth/teams/$TEAM_ID/api-keys?aclFilters=api-key:endpoint:chat" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Dan il-filtru huwa dak li jagħmel awditu ġestibbli anke meta jkollok aktar minn għaxar ċwievet. Fil-prattika, jitqajmu żewġ mistoqsijiet li jiġu mwieġba b’talba waħda: min jista’ jsejjaħ l-aktar mudell għali, u liema ċwievet għadhom iġorru wildcard. It-tieni waħda hija l-aktar utli—wildcard minsija fil-produzzjoni hija l-iżball ta’ konfigurazzjoni l-aktar komuni, u l-aktar wieħed silenzjuż.

Paġinazzjoni

Għal timijiet b’ħafna ċwievet, uża l-paġinazzjoni:

# L-ewwel paġna ta' 10 ċwievet
curl "https://management-api.x.ai/auth/teams/$TEAM_ID/api-keys?pageSize=10" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

# Il-paġna li jmiss bit-token irċevut
curl "https://management-api.x.ai/auth/teams/$TEAM_ID/api-keys?pageSize=10&paginationToken=TOKEN_RECU" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Immodifika ċavetta eżistenti

Il-modifika minflok il-ħolqien mill-ġdid mhix sempliċiment konvenjenza: iċ-ċavetta sigrieta tibqa’ l-istess, allura m’hemmx bżonn ta’ deploy. Dan jippermettilek taġġusta l-limiti jew tirrestrinġi l-permessi mingħajr interruzzjoni tas-servizz—u, f’każ ta’ suspett, tnaqqas id-drittijiet ta’ ċavetta f’sekondi waqt li tħejji r-rotazzjoni tagħha.

curl -X PUT "https://management-api.x.ai/auth/api-keys/$API_KEY_ID" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "prod-backend-v3",
    "acls": [
      "api-key:endpoint:chat",
      "api-key:endpoint:embed",
      "api-key:model:grok-4.20-0309-reasoning"
    ],
    "qps": 30,
    "qpm": 1000,
    "tpm": 3000000
  }'

X’tista’ timmodifika

  • name: ibdel isem iċ-ċavetta biex tirrifletti bidla fl-użu
  • acls: żid jew neħħi permessi (endpoints, mudelli)
  • qps / qpm / tpm: aġġusta l-limiti tar-rata (rate limits)
  • expireTime: estendi jew qassar il-perjodu ta’ validità

X’ma tistax timmodifika

  • L-identifikatur taċ-ċavetta (api_key_id) jibqa’ fiss
  • Iċ-ċavetta sigrieta ma tinbidilx waqt il-modifika (uża r-rotazzjoni għal dan)
  • It-tim sid ma jistax jiġi ttrasferit

Iċċekkja l-propagazzjoni

Hawnhekk tidħol id-dettall li jispjega nofs il-”bugs” irrappurtati wara modifika ta’ ċavetta: il-bidla mhix istantanja fuq is-servers kollha. Ċavetta maħluqa reċentement tista’ tirritorna 401 għal ftit mumenti, ACL espans tista’ ma tkunx attiva għada—u inti tfittex l-iżball fil-kodiċi tiegħek stess meta kollok biss bżonn tistenna. L-endpoint tal-propagazzjoni jeżisti preċiżament biex ineħħi dan id-dubju:

curl "https://management-api.x.ai/auth/api-keys/$API_KEY_ID/propagation" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Dan l-endpoint jirritorna l-istatus tal-propagazzjoni taċ-ċavetta. Stenna sakemm titlesta l-propagazzjoni qabel ma tuża ċ-ċavetta fil-produzzjoni, speċjalment wara li timmodifika l-ACLs.

Xenarji komuni

Aġġorna ċavetta ta’ dev għal prod

Il-passaġġ lejn il-produzzjoni huwa l-aktar xenarju komuni ta’ modifika, u r-rifless li toħloq ċavetta ġdida f’din l-okkażjoni huwa għali: trid tiddeployjah kullimkien, taġġorna l-vaults, u dik antika tibqa’ hemm għal żmien indefinit. Li tgħolli l-limiti fuq iċ-ċavetta eżistenti jevita dan kollu.

curl -X PUT "https://management-api.x.ai/auth/api-keys/$API_KEY_ID" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "prod-chatbot",
    "qps": 50,
    "qpm": 2000,
    "tpm": 5000000
  }'

Irrestrinġi ċavetta ssuspettata li ġiet kompromessa

F’każ ta’ suspett, l-ordni tal-operazzjonijiet hija importanti. Irrestrinġi l-ewwel—ACLs vojta, limiti ta’ rata żero—iwaqqaf it-telf f’talba waħda, mingħajr ma tkisser xi ħaġa b’mod irreversibbli. Ir-rotazzjoni tiġi wara, offline, ladarba tkun identifikajt fejn intużat iċ-ċavetta. Ir-reverse iħallik bil-produzzjoni waqfa u investigazzjoni li trid twettaq taħt pressjoni.

curl -X PUT "https://management-api.x.ai/auth/api-keys/$API_KEY_ID" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "acls": [],
    "qps": 0,
    "qpm": 0
  }'

Punti Ewlenin

  • GET /auth/teams/{teamId}/api-keys jelenka ċ-ċwievet kollha bil-paġinazzjoni u l-filtru ACL
  • PUT /auth/api-keys/{apiKeyId} jimmodifika l-parametri mingħajr ma jbiddel iċ-ċavetta sigrieta
  • GET /auth/api-keys/{apiKeyId}/propagation jivverifika li l-bidliet huma effettivi
  • Uża l-filtru ACL biex tagħmel awditu regolari tal-aċċess tat-tim tiegħek
  • Wara kwalunkwe modifika, iċċekkja l-propagazzjoni qabel ma tuża ċ-ċavetta fil-produzzjoni