API dhe çelësat API
Një asistent si Claude ose ChatGPT lidhet përmes faqes së autorizimit të To Bill: shihni Lidhni një asistent IA. Një mjet që nuk e ka këtë faqe, një skript, një klient MCP në rresht komandash ose një automatizim, përdor një çelës personal API. Kjo faqe shpjegon çelësat dhe jep adresat teknike.
Adresat
| Çfarë | Adresa |
|---|---|
| Serveri MCP (asistentët IA) | https://app.tobill.ch/mcp |
| API e To Bill | https://app.tobill.ch/api/… |
| Zbulimi OAuth | https://app.tobill.ch/.well-known/oauth-authorization-server |
| Referenca e API-së (beta) | https://docs.tobill.ch/api |
Serveri MCP i jep asistentit mjete të gatshme për kontabilitetin dhe faturimin, si dhe dy mjete që hapin gjithë pjesën tjetër të To Bill: njëri kërkon rrugën e duhur të API-së, tjetri e thërret, me të njëjtat kontrolle si aplikacioni.
Referenca e API-së përshkruan çdo rrugë që hap një çelës, me parametrat, përgjigjet dhe shembujt; versioni interaktiv ju lejon të provoni një kërkesë me çelësin tuaj.
Krijoni një çelës
- Hapni Cilësimet › Lidhjet IA dhe API.
- Nën Çelësat personalë API, klikoni Krijo një çelës.
- Jepini një Emri që tregon për çfarë shërben, zgjidhni Qasja (Vetëm lexim ose Lexim dhe ndryshim) dhe Vlefshmëria (30, 90 ose 365 ditë), pastaj klikoni Krijo çelësin.
- Kopjoni çelësin: ai shfaqet vetëm një herë. Pastaj klikoni E kopjova çelësin.
Çelësi fillon me tb_pk_. Ai hap ndërmarrjen ku ishit kur e krijuat, me të drejtat tuaja në atë ndërmarrje. Më pas lista tregon fillimin e tij, qasjen, ndërmarrjen, datën e skadimit dhe përdorimin e fundit, kurrë çelësin e plotë.
Një çelës është një fjalëkalim
Kushdo që ka çelësin vepron në To Bill në emrin tuaj. Mos e vendosni as në një e-mail, as në një dokument të ndarë, as në një depo kodi. Një çelës i humbur revokohet menjëherë (shihni më poshtë) dhe zëvendësohet me një të ri.
Dërgoni çelësin
Çdo kërkesë e mban çelësin në kokën HTTP Authorization, si token Bearer:
curl https://app.tobill.ch/api/clients -H "Authorization: Bearer tb_pk_…"Claude Code me një çelës
claude mcp add --transport http tobill https://app.tobill.ch/mcp --header "Authorization: Bearer tb_pk_…"Çfarë hap një çelës dhe çfarë nuk hap
- Me Vetëm lexim, çelësi vetëm lexon: çdo ndryshim refuzohet.
- Me Lexim dhe ndryshim, ai bën atë që mund të bëni ju në ndërmarrje, me të njëjtat kontrolle si aplikacioni, dhe kurrë më shumë se të drejtat e rolit tuaj.
- Ai nuk hap as identifikimin në llogarinë tuaj, as abonimin, as pagesat, as menaxhimin e lidhjeve dhe të çelësave, as një ndërmarrje tjetër, as cockpit-in e një fiduciari.
- Çdo ndryshim i bërë me çelësin regjistrohet në aktivitetin e ndërmarrjes me emrin që i keni dhënë.
- To Bill e kufizon numrin e kërkesave për minutë dhe për çelës; përtej kufirit, i refuzon kërkesat për një kohë dhe mjeti duhet të presë para se të provojë përsëri.
Revokoni një çelës
Te Cilësimet › Lidhjet IA dhe API, klikoni Revoko pranë çelësit, pastaj konfirmoni. Ai nuk funksionon më, menjëherë. Një çelës që ka skaduar mbetet në listë, i shënuar I skaduar, derisa ta revokoni.