Cheile API Fixh IT transformă software-ul centrului tău de service într-o platformă deschisă: din Companie > Chei API, compania ta poate genera și revoca chei API REST v1, folosite în antetul X-API-Key pentru a autentifica cererile către endpointul /api/v1/company/... Nu este o funcție doar pentru programatori izolați: este puntea dintre atelierul tău de reparații și restul ecosistemului tău software, de la site-ul web la programul de contabilitate, de la CRM la botul care răspunde clienților tăi. Din motive de securitate, cheia completă este afișată pe ecran o singură dată, imediat după creare: din acel moment este vizibilă doar sub formă mascată (key_prefix), așa că trebuie copiată și păstrată imediat într-un loc sigur.
De ce este important pentru un centru de service
Un atelier de reparații telefoane și calculatoare lucrează rareori cu un singur instrument: există sistemul principal de gestiune, poate un magazin online de piese de schimb, un chatbot care răspunde clienților pe WhatsApp sau Telegram, un software de contabilitate pentru facturare, un instrument de marketing pentru campanii de e-mail. Fără o integrare reală, toate aceste informații rămân izolate în fiecare sistem, obligând personalul să introducă aceleași date de mai multe ori, cu riscul real de erori de transcriere și întârzieri în comunicarea cu clientul. Cheile API REST v1 rezolvă exact această problemă: permit unui sistem extern să comunice automat cu datele de reparații ale companiei tale de pe Fixh IT, citind statusul unui bon, creând reparații noi dintr-un formular online sau actualizând un bon când un tehnician marchează o intervenție ca finalizată. Pentru un centru de service care gestionează zeci sau sute de reparații pe lună, această integrare între reparațiile de telefoane și calculatoare și software-ul extern poate face diferența dintre un flux de lucru fluid și unul plin de introduceri manuale duplicate.
În practică
Fiecare cheie API generată este asociată companiei tale (key_type "company") și permite unui sistem extern să se autentifice în fața API-urilor REST v1 ale Fixh IT incluzând cheia în antetul X-API-Key al fiecărei cereri HTTP. Cu acest tip de cheie poți consulta lista reparațiilor companiei tale cu filtre pe magazin, status sau text de căutare, poți citi detaliile unei reparații, poți crea altele noi specificând magazinul, clientul, tehnicianul, dispozitivul, defecțiunea constatată, accesoriile predate și devizul, sau poți actualiza o reparație existentă schimbându-i statusul, plata, livrarea sau notele interne. Fiecare cerere este întotdeauna filtrată automat în funcție de compania căreia îi aparține cheia: un sistem extern nu poate niciodată vedea sau modifica datele altei companii din rețea, nici măcar din greșeală, deoarece controlul se face pe server la fiecare interogare.
Din motive de securitate, cheia completă (șirul secret real) este afișată pe ecran o singură dată, imediat după creare: din acel moment sistemul păstrează doar un hash al cheii și afișează în listă doar prefixul inițial (key_prefix), suficient pentru a o recunoaște, dar nu pentru a o reutiliza. De aceea este esențial să copiezi imediat cheia și să o lipești în fișierul de configurare al sistemului extern care o va folosi, înainte de a închide fereastra: dacă uiți, singura soluție este să revoci acea cheie și să generezi una nouă. Fiecare cheie afișează și data ultimei utilizări, utilă pentru a înțelege dacă o integrare este încă activă sau poate fi dezactivată fără probleme deoarece nu mai este folosită. Dacă o cheie este pierdută, compromisă sau nu mai este necesară, o poți revoca oricând din listă: odată revocată, încetează imediat să funcționeze, data revocării este înregistrată, iar orice sistem care o folosea pierde instant accesul la API, fără a fi nevoie de intervenții în altă parte.
Pe lângă cheile de tip companie, în același sistem tehnic există și un tip de cheie rezervat distribuitorilor din rețeaua Fixh IT, folosit pentru a gestiona automat emiterea și controlul codurilor de licență din propriul software de gestiune: cele două tipuri de chei sunt complet separate (protecții și permisiuni diferite), iar o cheie de companie nu poate fi niciodată folosită pentru operațiuni rezervate distribuitorilor, și invers.
Ghid rapid
- Mergi la Companie > Chei API.
- Creează o cheie API nouă, atribuindu-i un nume descriptiv care identifică clar integrarea (de exemplu „Magazin online de piese" sau „Bot suport WhatsApp").
- Copiază imediat cheia completă afișată pe ecran: nu va mai fi afișată integral ulterior, doar în formă mascată.
- Lipește cheia în fișierul de configurare al sistemului extern, în variabila prevăzută pentru antetul X-API-Key.
- Configurează sistemul extern să trimită cheia în antetul X-API-Key la fiecare cerere către /api/v1/company/repairs și celelalte endpointuri disponibile.
- Testează integrarea cu un apel de probă, de exemplu citirea listei de reparații, pentru a verifica dacă răspunsul conține datele așteptate.
- Verifică periodic data ultimei utilizări a fiecărei chei pentru a identifica integrările care nu mai sunt active.
- Dacă este necesar, revocă cheia din listă pentru a-i opri imediat utilizarea, de exemplu atunci când schimbi furnizorul site-ului web sau renunți la un instrument extern.
Cazuri de utilizare reale
Formular de solicitare reparație pe site. Un atelier de reparații telefoane integrează pe site un formular „solicită o reparație": când un client îl completează, un script extern apelează endpointul de creare a reparației cu antetul X-API-Key, generând automat un bon nou în sistem, deja atribuit magazinului corect și gata să fie preluat de un tehnician, fără ca nimeni să trebuiască să copieze manual datele de pe site în sistem.
Sincronizare cu un sistem de contabilitate extern. O companie cu mai multe magazine folosește un software de contabilitate separat pentru facturare: o integrare programată citește în fiecare noapte, prin cheia API, reparațiile marcate ca plătite și livrate în ultimele 24 de ore, și le importă în sistemul contabil pentru înregistrarea fiscală, evitând introducerea manuală dublă a datelor.
Notificări automate către client prin bot. Un centru de service conectează un bot de mesagerie la sistemul său: când un tehnician actualizează statusul unei reparații din „în lucru" în „gata de ridicare" prin API, botul extern verifică periodic reparațiile actualizate recent și trimite automat un mesaj clientului, reducând apelurile la magazin pentru a întreba despre stadiul reparației.
Sfaturi și bune practici
Creează o cheie API distinctă pentru fiecare integrare, în loc să reutilizezi aceeași cheie peste tot: astfel, dacă un sistem extern este dezafectat sau compromis, poți revoca doar acea cheie fără a fi nevoie să reconfigurezi toate celelalte integrări. Dă fiecărei chei un nume descriptiv care să-ți amintească dintr-o privire la ce servește, mai ales dacă în timp acumulezi mai multe. Verifică periodic data ultimei utilizări pentru a identifica cheile „uitate" legate de sisteme pe care nu le mai folosești, și revocă-le: mai puține chei active înseamnă o suprafață de atac mai mică. Păstrează cheia completă într-un manager de parole sau într-un fișier de configurare protejat, niciodată într-un document partajat sau într-un mesaj de chat.
Greșeli frecvente de evitat
Nu partaja niciodată aceeași cheie API între mai multe integrări diferite: dacă va trebui să dezactivezi una în viitor, riști să întrerupi și pe celelalte. Nu introduce cheia direct în codul sursă public al unui site sau al unei aplicații: trebuie să rămână întotdeauna într-un fișier de configurare separat și neversionat. Nu te aștepta să poți recupera cheia completă după ce ai închis fereastra prima dată: dacă uiți să o copiezi, singura soluție este să o revoci și să generezi una nouă. În cele din urmă, nu uita să revoci cheile integrărilor dezafectate: o cheie activă dar nefolosită rămâne un punct de acces potențial la datele reparațiilor tale.
Află mai multe
- Fixh Assistant: chatbotul WhatsApp cu Fixh AI pentru service-ul tău
- Vitrina Companiei: vinde online produsele din depozitul tau
- Exportă toate datele companiei: reparații, documente, clienți și bonuri într-o arhivă ZIP
Întrebări frecvente
Pot revedea cheia completă după ce am creat-o? Nu, din motive de securitate cheia completă este afișată doar la creare; dacă o pierzi, trebuie să o revoci și să generezi una nouă.
Ce se întâmplă dacă revoc o cheie API? Cheia încetează imediat să funcționeze, data revocării este înregistrată, iar orice cerere care o folosește este respinsă de sistem.
Pot crea mai multe chei API pentru aceeași companie? Da, poți genera mai multe chei, de exemplu una pentru fiecare integrare sau sistem extern conectat, și le poți revoca individual fără a afecta celelalte.
Ce date pot citi sau scrie cu o cheie API de companie? Reparațiile companiei tale: le poți lista, filtra după magazin sau status, crea altele noi și actualiza statusul, plata, livrarea și notele interne ale celor existente, întotdeauna limitate automat la compania ta.
Cheile API sunt diferite de cele folosite de distribuitori pentru licențe? Da, există două tipuri de chei complet separate: cele de companie pentru reparații și cele de distribuitor pentru gestionarea codurilor de licență, cu permisiuni și domenii distincte.
Este nevoie de competențe tehnice pentru a folosi cheile API? Da, integrarea necesită ca sistemul extern (site, bot, software terț) să fie programat să trimită cereri HTTP cu antetul X-API-Key: este destinată dezvoltatorilor sau furnizorilor de software care colaborează cu centrul tău de service.
