Fíordheimhniú le token Bearer
Ar an leathanach seo
Déan do ghlaoithe API slán
Ní mór gach iarratas a sheoltar chuig API xAI a fhíordheimhniú. Úsáideann an API an scéim Bearer token, caighdeán atá glactha go forleathan le haghaidh APIanna REST. Míníonn an ceacht seo conas a oibrí an mheicníocht agus na cleachtais is fearr chun do chuid eochracha a chosaint i dtimpeallachtaí táirgeachta.
An scéim Bearer token
Mar a thugann an t-ainn le fios, is féidir leis an duine ar bith a bhfuil an token ina sheilbh (“bears”) teacht ar an API. Sin an fáth go bhfuil sé ríthábhachtach do eochair a chosaint: níl aon seiceáil aitheantais ann seachas an token féin.
Formáid an cheanntáisc
Ní mór an ceanntásc Authorization a bheith i ngach iarratas HTTP leis an réimír Bearer agus do eochair ina dhiaidh:
Authorization: Bearer xai-your-api-key
Le cURL, seo mar a dhéantar é:
curl https://api.x.ai/v1/responses \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "grok-4.5", "input": "Hello"}'
I bPython, láimhseálann na SDKanna an ceanntásc seo go huathoibríoch nuair a chuireann tú an eochair ar fáil don tógálaí cliant.
Earráidí fíordheimhnithe
HTTP 401 Unauthorized
Ciallaíonn an earráid seo go bhfuil do eochair in easnamh, neamhbhailí, nó tarraingthe siar. Seiceáil:
- Go bhfuil an athróg timpeallachta
XAI_API_KEYsocraithe - Go dtosaíonn an eochair le
xai- - Nár tarraingíodh siar an eochair sa chonsól
HTTP 403 Forbidden
Tá do eochair bailí ach níl na ceadanna a theastaíonn don ghníomh iarrtha aige. Tarlaíonn sé seo uaireanta le srianta foirne ar oibríochtaí áirithe.
Cleachtais slándála is fearr
Ná nocht eochair riamh i gcód
Ní mór d’eochracha a bheith i bhfolach i gcónaí; ná cuir i dtéacs simplí iad in:
- Foinsechód leaganaithe (Git)
- Logaí feidhmchláir
- URLanna nó paraiméadair cheiste
- Teachtaireachtaí earráide a thaispeántar d’úsáideoirí
- Saincheisteanna agus iarratais tarraingthe GitHub
Úsáid stóras rúnda
I dtimpeallachtaí táirgeachta, stóráil do chuid eochracha i gcóras tiomnaithe:
- AWS Secrets Manager nó Parameter Store
- Google Secret Manager
- Azure Key Vault
- HashiCorp Vault
- Rúnda d’ardán CI/CD (GitHub Actions, GitLab CI)
Rothlú eochracha
Athraigh do chuid eochracha go rialta, agus láithreach má amhrasann tú go bhfuil sceitheadh ann:
- Cruthaigh eochair nua sa chonsól xAI
- Nuashonraigh an eochair i do stóras rúnda
- Ath-imlonnaigh d’fheidhmchlár
- Seiceáil go n-oibríonn gach rud leis an eochair nua
- Tarraing siar an sean-eochair sa chonsól
Teorainn a chur le ceadanna
Má oibríonn tú i bhfoireann, cruthaigh eochracha ar leith do gach seirbhís agus timpeallacht. Má sháraítear ceann amháin, fanfaidh an tionchar teoranta do chomhthéacs amháin.
Brath sceitheadh
Ligeann an réimír xai- d’uirlisí braite (scanadh rúnda GitHub, GitGuardian, TruffleHog) eochracha a aithint sa fhoinsechód go huathoibríoch. Cuir na huirlisí seo ar siúl i do stórtha ionas go gcuirfear in iúl duit láithreach i gcás nochta thaismeanaigh.
Má bhrathfar eochair i gcoiste poiblí:
- Tarraing siar é láithreach sa chonsól xAI
- Seiceáil do stair úsáide le haghaidh úsáide chalaoise
- Cruthaigh eochair nua
- Glan do stair Git (nó fearr fós, meas an eochair mar sháraithe agus téigh ar aghaidh)
HTTPS ag teastáil
Ní ghlacann API xAI ach le ceangail HTTPS. Criptíonn TLS do chuid iarratas le linn aistrithe, an ceanntásc Authorization san áireamh. Ná déan iarracht riamh an chosaint seo a sheachaint: nochtfadh iarratas thar HTTP neamhchriptithe do eochair ar an líonra.
Príomhphointí
- Úsáideann an API an scéim Bearer token tríd an gceanntásc
Authorization - Is é an eochair an t-aon fhachtóir fíordheimhnithe: cosain é mar a chosófá pasfhocal
- Úsáid stóras rúnda i dtáirgeadh, agus ná crua-chódaigh eochair riamh
- Cuir brath sceitheadh ar siúl i do stórtha Git
- Rothlaigh eochracha go rialta agus tarraing siar aon eochair sáraithe láithreach
Seiceáil do thuiscint
Bunúis API xAI: seiceáil dheireanach sula dtosaíonn tú ag tógáil.
1. Cad ba chóir duit a dhéanamh le heochair API chomh luath agus a chruthaíonn tú é?
Freagra: Stóráil é in áit shábháilte (taispeántar é uair amháin), nocht é tríd an athróg XAI_API_KEY seachas é a chrua-chódú, úsáid eochair amháin in aghaidh na timpeallachta, agus déan tástáil air láithreach le glao chuig /v1/models.
2. Cad é an bun-URL, agus cén fáth a bhfuil sé chomh tábhachtach sin?
Freagra: https://api.x.ai/v1. Is é seo a dhéanann comhoiriúnacht OpenAI indéanta: is leor an base_url agus an eochair a athrú chun cód OpenAI atá ann cheana a dhíriú ar Grok.
3. Cé na SDKanna is féidir leat a úsáid le Grok?
Freagra: An SDK xAI dúchasach, an SDK OpenAI (le base_url xAI), agus an Vercel AI SDK ar thaobh JavaScript, chomh maith le cURL le haghaidh tástála: tá an éiceachóras oscailte.
4. Cad é an príomhphointe deiridh giniúna?
Freagra: POST /v1/responses, an fhormáid nua-aimseartha; fanann chat/completions ar fáil mar rogha oidhreachta le haghaidh comhoiriúnachta.
5. Conas a fhíordheimhnítear gach iarratas?
Freagra: Leis an gceanntásc Authorization: Bearer agus an eochair xai-…: an scéim chaighdeánach Bearer token, an rud céanna beag beann ar an SDK nó an uirlis.
Eochair shlán, an bun-URL, do rogha SDK, Bearer i ngach áit: tá an bonn curtha, agus tá na chéad chúrsaí API eile ag tógáil air.