Creează și administrează în siguranță chei API: citire, scriere, revocare

Ce este o cheie API

O cheie API este un șir lung și aleatoriu de caractere cu care un program se identifică la un serviciu. Cine o cunoaște poate face tot ce permite cheia. De aceea o cheie API trebuie păstrată în siguranță, ca o parolă. La Same-QR ai nevoie de ea pentru linia de comandă sameqr, pentru scripturi proprii care folosesc API-ul REST și pentru agenți de programare precum Claude Code, Cursor și Codex. ChatGPT și Claude.ai nu au nevoie de ea, ele se autentifică prin OAuth.

Pasul 1: Găsește locul potrivit

Conectează-te la dashboard și deschide Cont. Acolo se află secțiunea „Acces pentru CLI, scripturi și agenți”. Cheile se pot crea doar aici, cu o autentificare în browser. O cheie nu poate genera alte chei, așa că o cheie furată nu se înmulțește.

Pasul 2: Alege drepturile

Există trei trepte. Alege mereu cea mai mică, suficientă pentru sarcină.

• Rapoarte de scanare, evaluări, un asistent care doar răspunde la întrebări: doar citire.
• Scripturi care creează coduri QR și pagini, schimbă nume și texte, publică, importă meniuri: citire + scriere.
• Fluxuri care schimbă destinațiile codurilor QR existente, scot pagini offline sau le șterg: complet. Fiecare astfel de modificare necesită o confirmare cu starea citită, iar prin API sunt posibile cel mult 10 pe oră și 30 pe zi.

Cu o cheie de citire, orice cerere care modifică primește un refuz. Un agent de programare conectat prin MCP cu o cheie de citire nici măcar nu vede instrumentele de scriere.

Pasul 3: Durata de valabilitate și numele

Fiecare cheie expiră: după 30, 90, 180 sau 365 de zile, presetat este 90. Se poate și nelimitat, dar trebuie să alegi asta conștient, de exemplu pentru o sarcină nocturnă fără oameni care o reînnoiește. Dă cheii un nume după scopul ei, de exemplu „Raport lunar client A”. Sunt posibile până la 10 chei pentru fiecare cont.

Pasul 4: Păstrează-o imediat în siguranță

Cheia începe cu sqr_live_ și este afișată exact o dată. Same-QR salvează doar o sumă de control și nu ți-o mai poate arăta ulterior. Pune-o direct în managerul tău de parole. Programele o citesc la pornire din variabila de mediu SAMEQR_API_KEY. O cheie nu are ce căuta:

• în codul sursă, cu atât mai puțin într-un depozit public,
• într-o adresă, pentru că adresele ajung în jurnale și în istoric,
• într-un tabel, e-mail sau mesaj de chat,
• în chatul cu un asistent AI,
• ca argument într-o comandă, pentru că atunci rămâne în istoricul shell-ului.

Începutul fix sqr_live_ are un scop: instrumentele care caută secrete publicate din greșeală recunosc cheia după el.

Pasul 5: Revocă, dacă este nevoie

În aceeași listă revoci o cheie cu un clic. Ea devine imediat invalidă, iar codurile tale QR rămân neschimbate. Cheile expirate rămân în listă cu o mențiune, ca să vezi de ce un script nu mai trece brusc. O schimbare de parolă revocă în plus toate cheile deodată. Revocă o cheie dacă a devenit vizibilă undeva, dacă un prestator nu mai lucrează pentru tine sau dacă nu mai știi la ce servește.

Concluzie: de ce Same-QR

Same-QR ia cheile în serios: drepturi separate, durate de valabilitate cu o presetare rezonabilă, afișare o singură dată, salvare doar ca sumă de control și revocare cu efect imediat. Așa poți folosi API-ul, CLI-ul și agenții de programare cu încredere, în orice tarif.

Începe chiar acum: înregistrează-te gratuit pe sameqr.com, 20 de coduri QR dinamice sunt gratuite permanent. API, CLI și server MCP există în fiecare tarif, iar documentația se află pe sameqr.com/entwickler.

Întrebări frecvente