Gin agus Slánaigh do Eochair API
Ar an leathanach seo
An t-aitheantas a dheimhníonn do chuid iarratas
Deimhníonn do eochair API gach iarratas a sheoltar chuig samhlacha Mistral: gan é, ní ghlactar le haon ghlaoc. Smaoinigh air mar fhocal faire teicniúil, ach taistealaíonn sé trí chód, comhaid chumraíochta, agus píblínte imlonnaithe, rud a chiallaíonn go gcríochnaíonn sé i bhfad níos mó áiteanna ná gnáthfhocal faire. Is féidir le duine ar bith a bhfuil sé aige do chuóta a úsáid agus costais a ghiniúint ar do chuntas.
Gin do chéad eochair
Sa Chonsól Mistral, oscail do spás oibre agus téigh go dtí an roinn API Keys sa bharrthaobh. Cliceáil ar Create new key agus tabhair ainm cur síosach air, mar shampla dev-chatbot-mars-2026. Níl aon fheidhm theicniúil ag an ainm seo, ach sábhálfaidh sé an lá duit nuair a bheidh sé eochair ag comhfhreagairt sa liosta agus nuair a bheidh ort ceann amháin a chúlghairm: ní insíonn “eochair 3” aon rud duit, ach insíonn dev-chatbot-mars-2026 gach rud duit.
Taispeántar an eochair uair amháin, ag an am a chruthaítear í. Cóipeáil í láithreach agus stóráil í in áit shábháilte. Má dhúnann tú an fhuinneog sula gcóipeálann tú í, níl aon bhealach chun í a fháil ar ais: caithfidh tú ceann nua a ghiniúint. Is éard atá in eochair Mistral ná réimír agus teaghrán alfa-uimhriúil fada ina dhiaidh. Ná déan í a mheascadh le do Aitheantas Spáis Oibre nó le comhartha JWT: murab ionann agus an ceann deireanach, ní théann sí in éag léi féin agus fanann sí bailí go dtí go gcuireann tú ar ceal í.
Stóráil í gan í a chrua-chódú riamh
Tá an riail órga simplí: ná crua-chódaigh do eochair API sa chód foinse riamh. An lá a thiteann an comhad sin i stór comhroinnte, téann an eochair leis. Úsáid athróg timpeallachta i gcónaí ina ionad sin.
Ar Linux agus macOS, dearbhaigh í sa teirminéal:
export MISTRAL_API_KEY="your-api-key-here"
Imíonn an athróg seo nuair a dhúnann tú an teirminéal; chun í a dhéanamh buan, cuir an líne le do chomhad ~/.bashrc, ~/.zshrc, nó ~/.profile.
Ar Windows, seo a leanas an leagan coibhéiseach PowerShell:
$env:MISTRAL_API_KEY = "your-api-key-here"
Agus chun maireachtáil tar éis atosú seisiúin:
[System.Environment]::SetEnvironmentVariable("MISTRAL_API_KEY", "your-api-key-here", "User")
I dtionscadal feidhmchláir, is é an cleachtas is coitianta ná comhad .env a chruthú ag an bhfréamh:
MISTRAL_API_KEY=your-api-key-here
Cuir .env le do .gitignore láithreach—roimh do chéad ghealltanas, ní ina dhiaidh. I bPython, léann an leabharlann python-dotenv an comhad seo agus insteallann sé na hathróga ag am tosaithe, rud a thugann áisiúlacht comhaid áitiúil duit gan riosca rúin a chur faoi rialú leaganacha.
Rothlaigh do chuid eochracha
Cuir eochair in ionad eile ar chúis amháin de thrí chúis. Láithreach, má nochtadh í ar bhealach ar bith: gealltanas a bhrúigh tú chuig stór Git poiblí, teachtaireacht Slack dheifrideach, nó iarsmaí i logaí freastalaí. Go rialta i dtáirgeadh, agus is minicíocht réasúnta gach nócha lá. Agus nuair a fhágann comhoibritheoir a raibh rochtain aige/aici, an lá céanna a thugann sé/sí a bhadzs ar ais.
Seachnaíonn an nós imeachta cur isteach ar sheirbhís má urramaíonn tú an t-ord:
- Gin eochair nua sa Chonsól
- Nuashonraigh an athróg timpeallachta i do chuid imlonnuithe go léir
- Fíoraigh go n-oibríonn gach rud leis an eochair nua
- Cúlghairm an tseaneochair ach amháin tar éis an fhíoraithe seo
Is é malartú céimeanna 3 agus 4 an botún clasaiceach: cúlghairmeann tú ar dtús “chun a bheith sábháilte”, ach ansin faigheann tú amach go raibh seirbhís dhearmadta fós ag úsáid na seaneochrach. Cinntíonn an rothlú gan am stad nach dteipeann ar aon chomhpháirt le linn an aistrithe.
Laghdaigh an dromchla nochta
Má ghlaocann feidhmchláir iolracha ar an API, cruthaigh eochair amháin in aghaidh an fheidhmchláir. Má sháraítear ceann amháin, ní gá duit ach an eochair sin a chúlghairm gan na cinn eile a stopadh. Ar an bprionsabal céanna, ná húsáid eochair táirgeachta riamh i bhforbairt: is é sin go díreach an timpeallacht ina sreabhann rúin go saor.
Ina theannta sin, déan monatóireacht ar úsáid ón gConsól, a nochtann logaí úsáide do gach eochair. Ba chóir do mhéadú tobann i dtócan nó i nglaotha ó sheoladh IP anaithnid rothlú láithreach a spreagadh, gan fanacht le deimhniú teagmhais.
Tá trí earráid dheireanacha fiú lua mar gheall go mbuaileann muid leo gach seachtain. Fanann eochair a foilsíodh i stór Git poiblí inléite sa stair fiú tar éis an comhad a scriosadh: is é an freagra bailí amháin ná cúlghairm. Déantar eochair a sheoltar i ngnáth-théacs trí ríomhphost nó teachtaireacht mheandarach a chartlannú go deo ar fhreastalaithe nach bhfuil faoi do smacht agat. Agus táirgeann eochair atá imithe in éag nó cúlghairthe agus atá fós in imlonnú earráidí 401 Unauthorized a thógann uair an chloig go minic le diagnóisiú simplí toisc nár smaoinigh aon duine seiceáil.
Príomhphointí
- Gin do chuid eochracha ón roinn API Keys de do spás oibre sa Chonsól Mistral
- Stóráil iad go heisiach in athróga timpeallachta nó i mbainisteoir rúin
- Déan rothlú rialta agus rothlú láithreach i gcás nochta
- Cruthaigh eochair amháin in aghaidh an fheidhmchláir chun tionchar sáraithe a theorannú
- Cuir
.envle do.gitignorei gcónaí