Kle API: konekte yon lòt sistèm ak estidyo ou
Kisa sa ye
Seksyon ki rele « Kisa sa ye »Kle API a pèmèt yon lòt sistèm (tankou yon ERP, yon fèy kalkil otomatik, yon sit entènèt oswa yon aplikasyon pa w) konsilte epi anrejistre done estidyo ou a san pèsonn pa bezwen antre yo alamen. Chak kle aji tankou yon itilizatè estidyo a: li kapab fè tout sa itilizatè sa a kapab fè, men li pa kapab fè anyen anplis.
Kilè pou itilize l
Seksyon ki rele « Kilè pou itilize l »- Yon sistèm jesyon bezwen li lavant jounen an pou kontablite.
- Yon sit entènèt oswa yon aplikasyon pa w bezwen anrejistre kliyan oswa konsilte katalòg la.
- Yon sistèm otomatik bezwen anrejistre depans oswa konsilte kont kliyan yo dwe peye.
Anvan ou kòmanse
Seksyon ki rele « Anvan ou kòmanse »Se sèlman moun ki administre estidyo a (ki gen aksè konplè oswa pèmisyon pou modifye Pwofil ak Itilizatè) ki ka kreye, modifye epi revoke kle. Si ou pa ka kreye yon kle, mande pwopriyetè estidyo a ba ou aksè nan Aksè → Pwofil.
Nou rekòmande pou ou kreye yon itilizatè espesyal pou entegrasyon an anvan, ak yon pwofil ki pèmèt aksè sèlman nan ekran lòt sistèm nan bezwen sèvi ak yo. Kle a pran pèmisyon itilizatè sa a.
Etap pa etap
Seksyon ki rele « Etap pa etap »Etap 1 — Louvri onglet API Key la
Seksyon ki rele « Etap 1 — Louvri onglet API Key la »Nan Paramèt → Konpayi, louvri onglet API Key la. La a, w ap jwenn lis kle ki deja kreye yo, ansanm ak itilizatè chak kle, IP otorize, Validite ak Dènye itilizasyon.
Etap 2 — Kreye kle a
Seksyon ki rele « Etap 2 — Kreye kle a »Klike sou Nouvo kle, antre Non a epi chwazi Itilizatè a. Nan IP otorize, mete yon adrès IP oswa yon seri adrès, youn sou chak liy, pou aksepte apèl ki soti nan adrès sa yo sèlman (si lis la vid, nenpòt adrès IP ap mache). Nan Validite, chwazi Pa janm ekspire oswa Ekspire nan epi chwazi yon dat: kle a ap valab jouk nan fen jou sa a. Klike sou Kreye kle epi kopi kle a ak bouton kopi a. Yo pap montre kle a ankò.
Lòt sistèm nan dwe voye kle a nan chak apèl, nan antèt Authorization, konsa:
Authorization: Bearer hk_... (mete kle a nèt nan plas hk_...).
Pou sèvi ak kle a nan yon IA (Claude Code, Gemini CLI, Cursor), chwazi tou Pèmèt itilizasyon kòm konektè IA nan Konektè IA. San opsyon sa a, kle a ap mache pou entegrasyon yo, men li pap mache ak konektè a. Gade atik la Konektè IA.
Etap 3 — Revoke yon kle
Seksyon ki rele « Etap 3 — Revoke yon kle »Nan lis la, klike sou ikòn poubèl la bò kote kle a epi konfime ak Revoke. Sistèm ki t ap sèvi ak kle a ap pèdi aksè nan 30 segonn pou pi ta. Pou chanje non an, adrès IP yo oswa dat ekspirasyon an, sèvi ak ikòn kreyon an.
Sa k ap pase apre
Seksyon ki rele « Sa k ap pase apre »- Tout chanjman lòt sistèm nan fè ak kle a parèt nan Odit la, ak orijin Kle API, sou non itilizatè kle a.
- Kle a sispann mache otomatikman lè li ekspire oswa lè yo dezaktive itilizatè ki asosye avè l la nan estidyo a. Nan lis la, l ap parèt kòm Ekspire oswa Itilizatè inaktif.
- Yon kle pa janm bay aksè ak yon lòt konpayi, menm si itilizatè ki asosye avè l la ap travay nan yon lòt konpayi tou.
Erè kouran ak kesyon
Seksyon ki rele « Erè kouran ak kesyon »K: Èske kle a ka fè tout bagay nan sistèm nan? R: Non. Li gen menm pèmisyon ak itilizatè ki asosye avè l la, epi se nan estidyo sa a sèlman. Gen kèk seksyon ki pa janm aksepte kle, menm si itilizatè a gen aksè konplè: koneksyon ak chanjman konpayi, ekran jesyon kle yo, jesyon itilizatè ak envitasyon, Heya, sipò, tablodbò, paramèt jeneral Konpayi an (logo, orè, jou ferye, domèn, imèl rapò yo) ak ekran platfòm nan. Si ou gen plizyè entegrasyon, kreye yon itilizatè pou chak: nan Odit la, chanjman yo ap parèt sou non itilizatè kle a.
K: Mwen pèdi kle a. Èske m ka wè l ankò? R: Non. Sistèm nan konsève sèlman yon anprent kle a, li pa janm konsève kle a menm. Revoke ansyen kle a epi kreye yon lòt.
K: Lòt sistèm nan montre mesaj “Adrès IP sa a pa otorize pou sèvi ak kle API sa a.” Kisa pou m fè? R: Adrès IP lòt sistèm nan ap itilize pou fè apèl la pa nan lis IP otorize la. Modifye kle a epi ajoute adrès IP a, oswa kite lis la vid pou aksepte nenpòt adrès IP.
K: Lòt sistèm nan montre mesaj “Yo pa ka sèvi ak wout sa a avèk yon kle API.” Poukisa? R: L ap rele youn nan seksyon ki pa aksepte kle yo (gade premye kesyon an). Se yon moun ki dwe fè operasyon sa yo sou ekran an.
K: Èske m ka chanje itilizatè ki asosye ak yon kle? R: Non. Revoke kle a epi kreye yon lòt pou nouvo itilizatè a.
K: Lis itilizatè yo vid lè m ap kreye yon nouvo kle. Poukisa? R: Itilizatè ekip platfòm nan pa ka gen kle API, kidonk yo pa parèt nan lis la. Anrejistre yon itilizatè pou estidyo a (li pi bon si se yon itilizatè espesyal pou entegrasyon an) epi kreye kle a pou li.