Liostaigh agus athraigh do chuid eochracha
Ar an leathanach seo
Fardal do chuid eochracha API
Le himeacht ama, carnann do fhoireann eochracha API do thimpeallachtaí, tionscadail agus baill foirne éagsúla. Ligeann an Bainistíocht API duit gach eochair ghníomhach a liostú, scagadh de réir ceadanna, agus a socruithe a athrú gan iad a athchruthú.
Eochracha a liostú
Is é an pointe tosaigh é an t-aiceann seo d’aon iniúchadh rochtana, agus is minic gurb é an áit a aimsíonn tú an fardal fíor: eochracha a cruthaíodh le haghaidh tástála ocht mí ó shin, eochair faoi ainm iar-bhaill foirne, dhá eochair táirgeachta nach bhfuil a fhios ag aon duine cé acu atá in úsáid. Déan liosta sula gcruthaíonn tú aon rud nua—b’fhéidir go bhfuil an eochair atá uait ann cheana féin.
curl "https://management-api.x.ai/auth/teams/$TEAM_ID/api-keys" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Paraiméadair iarratais
- pageSize: líon na n-eochracha in aghaidh na leathanaigh (de réir réamhshocraithe, filleann sé gach eochair)
- paginationToken: token chun an chéad leathanach eile a fháil má sháraíonn líon na n-eochracha méid an leathanaigh
- aclFilters: scag eochracha de réir ceadanna sonracha
Scagadh de réir ACL
Is féidir leat ach eochracha le leibhéal rochtana áirithe a fháil:
# Liostaigh ach eochracha le rochtain chomhrá
curl "https://management-api.x.ai/auth/teams/$TEAM_ID/api-keys?aclFilters=api-key:endpoint:chat" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Is é an scagadh seo a dhéanann iniúchadh inbhainistithe thar dhosaen eochair. Tagann dhá cheist chun cinn sa chleachtas agus freagraítear iad le hiarratas amháin: cé a bhfuil cead aige an tsamhail is costasaí a ghlaow, agus cé na heochracha a bhfuil cárta fiáin fúthu fós? Is é an dara ceann an ceann is úsáidí—is é cárta fiáin dearmadta sa táirgeadh an earráid cumraíochta is coitianta, agus an ceann is ciúine.
Leathanú
Do fhoirne a bhfuil go leor eochracha acu, bain úsáid as leathanú:
# An chéad leathanach de 10 n-eochair
curl "https://management-api.x.ai/auth/teams/$TEAM_ID/api-keys?pageSize=10" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
# An chéad leathanach eile leis an token a fuarthas
curl "https://management-api.x.ai/auth/teams/$TEAM_ID/api-keys?pageSize=10&paginationToken=TOKEN_RECU" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Eochair atá ann cheana a athrú
Ní áisiúlacht amháin é athrú seachas athchruthú: fanann an eochair rúnda mar an gcéanna, mar sin ní gá aon imlonnú. Ligeann sé seo duit teorainneacha a choigeartú nó ceadanna a shrianta gan briseadh seirbhíse—agus, má tá amhras ort, is féidir leat cearta eochrach a laghdú i gceann soicind agus tú ag ullmhú a rothlaithe.
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
}'
Cad is féidir leat a athrú
- name: athainmnigh an eochair chun athrú úsáide a léiriú
- acls: ceadanna a chur leis nó a bhaint (críochphointí, samhlacha)
- qps / qpm / tpm: teorainneacha ráta a choigeartú
- expireTime: an tréimhse bailíochta a fhadú nó a ghiorrú
Cad nach féidir leat a athrú
- Fanann aitheantóir na heochrach (
api_key_id) seasta - Ní athraíonn an eochair rúnda le linn athraithe (úsáid rothlú chuige sin)
- Ní féidir an fhoireann úinéireachta a aistriú
Seiceáil ar leathnú
Seo an mionsonra a mhíníonn leath na “bhfadhbanna” a thuairiscítear tar éis eochair a athrú: níl an t-athrú láithreach ar gach freastalaí. D’fhéadfadh eochair a cruthaíodh le déanaí 401 a thabhairt ar feadh cúpla nóiméad, b’fhéidir nach bhfuil ACL leathnaithe gníomhach fós—agus bíonn tú ag lorg na hearráide i do chód féin nuair nach raibh le déanamh agat ach fanacht. Tá an t-aiceann leathnaithe ann go sonrach chun an t-amhras seo a bhaint:
curl "https://management-api.x.ai/auth/api-keys/$API_KEY_ID/propagation" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Filleann an t-aiceann seo stádas leathnaithe na heochrach. Fan go mbeidh an leathnú críochnaithe sula n-úsáideann tú an eochair sa táirgeadh, go háirithe tar éis ACLanna a athrú.
Cásanna coitianta
Eochair forbartha a uasghrádú go dtí táirgeadh
Is é bogadh go dtí an táirgeadh an cás athraithe is coitianta, agus is costasach an frithghníomh eochair nua a chruthú ar an ócáid seo: caithfidh tú é a imlonnú i ngach áit, stórlanna a nuashonrú, agus fanann an sean-cheann ann go deo. Teorainneacha na heochrach atá ann cheana a ardú seachnaíonn sé seo ar fad.
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
}'
Eochair atá faoi amhras a bheith curtha i mbaol a shriantú
Má tá amhras ort, tá tábhacht le hord na n-oibríochtaí. Srian ar dtús—ACLanna folmha, teorainneacha ráta nialasacha—stopann sé an fhuiliú in iarratas amháin, gan aon rud a bhriseadh go do-aisiompaithe. Tagann an rothlú níos déanaí, as líne, nuair a bheidh a fhios agat cáit ar úsáideadh an eochair. Fágann an malairt thú le táirgeadh síos agus imscrúdú le déanamh faoi bhrú.
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
}'
Príomhphointí
- Déanann
GET /auth/teams/{teamId}/api-keysliostú ar gach eochair le leathanú agus scagadh ACL - Athraíonn
PUT /auth/api-keys/{apiKeyId}paraiméadair gan an eochair rúnda a athrú - Fíoraíonn
GET /auth/api-keys/{apiKeyId}/propagationgo bhfuil na hathruithe éifeachtach - Bain úsáid as scagadh ACL chun rochtain do fhoirne a iniúchadh go rialta
- Tar éis aon athraithe, seiceáil an leathnú sula n-úsáideann tú an eochair sa táirgeadh