Ustvari ključ API in ga varno upravljaj: branje, pisanje, preklic

Kaj je ključ API

Ključ API je dolgo, naključno zaporedje znakov, s katerim se program izkaže storitvi. Kdor ga pozna, lahko stori vse, kar ključ dovoljuje. Zato ključ API sodi v varno hrambo kot geslo. Pri storitvi Same-QR ga potrebuješ za ukazno vrstico sameqr, za lastne skripte na REST API-ju in za programerske agente, kot so Claude Code, Cursor in Codex. ChatGPT in Claude.ai ga ne potrebujeta, prijavita se prek OAuth.

Korak 1: Poišči pravo mesto

Prijavi se v nadzorno ploščo in odpri Račun. Tam je razdelek »Dostop za CLI, skripte in agente«. Ključe je mogoče ustvariti samo tukaj, s prijavo v brskalniku. Ključ ne more ustvariti drugih ključev, zato se ukraden ključ ne razmnožuje.

Korak 2: Izberi pravice

Stopnje so tri. Vedno izberi najmanjšo, ki zadošča za nalogo.

• Poročila o skeniranjih, analize, asistent, ki samo odgovarja na vprašanja: samo branje.
• Skripte, ki ustvarjajo QR kode in strani, spreminjajo imena in besedila, objavljajo, berejo jedilnike: branje + pisanje.
• Postopki, ki spreminjajo cilje obstoječih QR kod, strani umikajo s spleta ali jih brišejo: polno. Vsaka taka sprememba zahteva potrditev s prebranim stanjem, prek API-ja je mogočih največ 10 na uro in 30 na dan.

S ključem za branje je vsaka poizvedba, ki spreminja, zavrnjena. Programerski agent, ki je prek MCP povezan s ključem za branje, orodij za pisanje sploh ne vidi.

Korak 3: Veljavnost in ime

Vsak ključ poteče: po 30, 90, 180 ali 365 dneh, privzeto je 90. Mogoče je tudi neomejeno, vendar to moraš izbrati zavestno, na primer za nočno opravilo brez ljudi, ki ga obnavlja. Ključu daj ime po namenu, na primer »Mesečno poročilo stranka A«. Na račun je mogočih do 10 ključev.

Korak 4: Takoj ga varno shrani

Ključ se začne s sqr_live_ in se prikaže natanko enkrat. Same-QR shrani samo kontrolno vsoto in ti ga pozneje ne more pokazati znova. Shrani ga neposredno v upravitelj gesel. Programi ga ob zagonu preberejo iz okoljske spremenljivke SAMEQR_API_KEY. Ključ ne sodi:

• v izvorno kodo, še posebej ne v javno skladišče,
• v naslov, ker naslovi končajo v dnevnikih in zgodovinah,
• v preglednico, e-pošto ali klepetalno sporočilo,
• v klepet z AI-asistentom,
• kot argument v ukaz, ker potem ostane v zgodovini lupine.

Stalni začetek sqr_live_ ima namen: orodja, ki iščejo pomotoma objavljene skrivnosti, po njem prepoznajo ključ.

Korak 5: Po potrebi prekliči

Na istem seznamu ključ prekličeš z enim klikom. Takoj postane neveljaven, tvoje QR kode ostanejo nespremenjene. Potekli ključi ostanejo na seznamu z opombo, da vidiš, zakaj skripta nenadoma ne pride več skozi. Sprememba gesla dodatno prekliče vse ključe naenkrat. Ključ prekliči, če je kjer koli postal viden, če za tebe ne dela več izvajalec ali če ne veš več, čemu je namenjen.

Zaključek: zakaj Same-QR

Same-QR ključe jemlje resno: ločene pravice, veljavnost s smiselno privzeto nastavitvijo, prikaz samo enkrat, shranjevanje samo kot kontrolna vsota in preklic z neposrednim učinkom. Tako lahko API, CLI in programerske agente uporabljaš mirno, v vsakem tarifu.

Začni kar zdaj: brezplačno se registriraj na sameqr.com, 20 dinamičnih QR kod je trajno brezplačnih. API, CLI in strežnik MCP so na voljo v vsakem tarifu, dokumentacija je na sameqr.com/entwickler.

Pogosta vprašanja