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

Šta je API ključ

API ključ je dugačak, nasumičan niz znakova kojim se program predstavlja nekoj usluzi. Ko ga zna, može učiniti sve što ključ dozvoljava. Zato API ključ treba čuvati sigurno kao lozinku. U Same-QR-u ti treba za komandnu liniju sameqr, za vlastite skripte na REST API-ju i za coding agente poput Claude Codea, Cursora i Codexa. ChatGPT i Claude.ai ga ne trebaju, oni se prijavljuju putem OAuth-a.

Korak 1: Pronađi pravo mjesto

Prijavi se u kontrolnu tablu i otvori Račun. Tamo je odjeljak „Pristup za CLI, skripte i agente“. Ključevi se mogu kreirati samo ovdje, uz prijavu u pregledniku. Ključ ne može stvarati nove ključeve, tako da se ukradeni ključ ne razmnožava.

Korak 2: Odaberi prava

Postoje tri nivoa. Uvijek odaberi najmanji koji je dovoljan za zadatak.

• Izvještaji o skeniranjima, analize, asistent koji samo odgovara na pitanja: samo čitanje.
• Skripte koje kreiraju QR kodove i stranice, mijenjaju imena i tekstove, objavljuju, uvoze kartice: čitanje + pisanje.
• Procesi koji mijenjaju odredišta postojećih QR kodova, isključuju stranice ili ih brišu: potpuni. Svaka takva promjena traži potvrdu s pročitanim stanjem, putem API-ja je moguće najviše 10 na sat i 30 na dan.

S ključem za čitanje svaki zahtjev koji nešto mijenja dobija odbijenicu. Coding agent koji je putem MCP-a povezan s ključem za čitanje alate za pisanje uopće ne vidi.

Korak 3: Rok važenja i ime

Svaki ključ istječe: nakon 30, 90, 180 ili 365 dana, unaprijed je podešeno 90. Moguće je i bez ograničenja, ali to moraš svjesno odabrati, na primjer za noćni zadatak bez ljudi koji ga obnavljaju. Daj ključu ime prema njegovoj svrsi, na primjer „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 sa sqr_live_ i prikazuje se tačno jednom. Same-QR sprema samo kontrolni zbir i ne može ti ga kasnije ponovo pokazati. Odmah ga stavi u svoj menadžer lozinki. Programi ga pri pokretanju čitaju iz varijable okruženja SAMEQR_API_KEY. Ključ ne pripada:

• u izvorni kod, pogotovo ne u javni repozitorij,
• u adresu, jer adrese završavaju u zapisnicima i historiji,
• u tabelu, mejl ili poruku u chatu,
• u chat s AI asistentom,
• kao argument u komandi, jer tada stoji u historiji shella.

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

U istoj listi ključ opozivaš jednim klikom. Odmah postaje nevažeći, a tvoji QR kodovi ostaju nepromijenjeni. Istekli ključevi ostaju u listi s napomenom, da vidiš zašto skripta odjednom više ne prolazi. Promjena lozinke dodatno opoziva sve ključeve odjednom. Opozovi ključ ako je negdje postao vidljiv, ako neki pružalac usluga više ne radi za tebe ili ako više ne znaš čemu služi.

Zaključak: Zašto Same-QR

Same-QR ključeve shvata ozbiljno: odvojena prava, rokovi važenja s razumnom unaprijed podešenom vrijednošću, prikaz samo jednom, spremanje samo kao kontrolni zbir i opoziv s trenutnim djelovanjem. Tako API, CLI i coding agente možeš koristiti mirno, u svakoj tarifi.

Počni odmah: registruj se besplatno na sameqr.com, 20 dinamičkih QR kodova trajno je besplatno. API, CLI i MCP server dostupni su u svakoj tarifi, dokumentacija je na sameqr.com/entwickler.

Često postavljana pitanja