Izrada i sigurno upravljanje API ključevima: čitanje, pisanje, opoziv

Što je API ključ

API ključ je dugačak, nasumičan niz znakova kojim se program predstavlja usluzi. Tko ga zna, može učiniti sve što ključ dopušta. Zato API ključ treba čuvati sigurno kao zaporku. U Same-QR-u ti treba za naredbeni redak sameqr, za vlastite skripte na REST API-ju i za coding agente poput Claude Codea, Cursora i Codexa. ChatGPT i Claude.ai ne trebaju ga, prijavljuju se putem OAutha.

Korak 1: Pronađi pravo mjesto

Prijavi se u nadzornu ploču i otvori Račun. Tamo je odjeljak „Pristup za CLI, skripte i agente“. Ključeve možeš izraditi samo ovdje, uz prijavu u pregledniku. Ključ ne može stvarati nove ključeve, pa se ukradeni ključ ne može razmnožavati.

Korak 2: Odaberi prava

Postoje tri razine. Uvijek odaberi najmanju koja dostaje za zadatak.

• Izvještaji o skeniranju, analize, asistent koji samo odgovara na pitanja: samo čitanje.
• Skripte koje izrađuju QR kodove i stranice, mijenjaju imena i tekstove, objavljuju, učitavaju kartice: čitanje + pisanje.
• Postupci koji mijenjaju odredišta postojećih QR kodova, stavljaju stranice offline ili ih brišu: puni. Svaka takva promjena traži potvrdu s pročitanim stanjem, preko API-ja ide najviše 10 na sat i 30 na dan.

S ključem za čitanje svaki upit koji nešto mijenja dobiva odbijenicu. Coding agent povezan preko MCP-a s ključem za čitanje alate za pisanje uopće ne vidi.

Korak 3: Trajanje i ime

Svaki ključ istječe: nakon 30, 90, 180 ili 365 dana, zadano je 90. Moguće je i neograničeno, ali to moraš svjesno odabrati, primjerice za noćni zadatak bez čovjeka koji ga obnavlja. Daj ključu ime prema svrsi, primjerice „Mjesečni izvještaj klijent A“. Po računu je moguće do 10 ključeva.

Korak 4: Odmah ga sigurno spremi

Ključ počinje s sqr_live_ i prikazuje se točno jednom. Same-QR sprema samo kontrolni zbroj i ne može ti ga kasnije ponovno prikazati. Spremi ga izravno u svoj upravitelj zaporki. Programi ga pri pokretanju čitaju iz varijable okoline SAMEQR_API_KEY. Ključ ne pripada:

• u izvorni kod, a pogotovo ne u javni repozitorij,
• u adresu, jer adrese završavaju u zapisnicima i povijestima,
• u tablicu, e-poštu ili chat poruku,
• u chat s AI asistentom,
• kao argument u naredbi, jer tada ostaje u povijesti ljuske.

Fiksni početak sqr_live_ ima svrhu: alati koji traže slučajno objavljene tajne po tome prepoznaju ključ.

Korak 5: Opozovi ako je potrebno

Na istom popisu ključ opozivaš jednim klikom. Odmah postaje nevažeći, a tvoji QR kodovi ostaju nepromijenjeni. Istekli ključevi ostaju na popisu s napomenom kako bi vidio zašto skripta odjednom više ne prolazi. Promjena zaporke dodatno opoziva sve ključeve odjednom. Opozovi ključ ako je negdje postao vidljiv, ako davatelj usluge više ne radi za tebe ili ako više ne znaš čemu služi.

Zaključak: Zašto Same-QR

Same-QR ozbiljno shvaća ključeve: odvojena prava, trajanja sa smislenom zadanom vrijednošću, prikaz samo jednom, spremanje samo kao kontrolni zbroj i opoziv s trenutnim učinkom. Tako API, CLI i coding agente možeš koristiti bez brige, u svakom paketu.

Kreni odmah: registriraj se besplatno na sameqr.com, 20 dinamičkih QR kodova trajno je besplatno. API, CLI i MCP poslužitelj dostupni su u svakom paketu, dokumentacija se nalazi na sameqr.com/entwickler.

Često postavljana pitanja