Cum configurezi proxy-urile API
Un proxy API intermediază cererile dintre storefront și un serviciu extern. În
loc să expui direct adresa și credențialele serviciului în browser, configurezi
o adresă controlată de magazin. Adresa are forma /bridge/slug, unde slug-ul
este segmentul unic ales pentru acel proxy.
Folosește un proxy când tema sau alt cod executat în browser trebuie să apeleze un serviciu extern fără să expună credențialele acestuia. Integratorul sistemului extern trebuie să confirme că acest flux este potrivit înainte să creezi adresa publică.
Pentru primul test, folosește un singur slug și o destinație de test care nu procesează date reale. Acțiunea Previzualizare trimite efectiv o cerere către serviciul extern, deci verifică destinația împreună cu integratorul sistemului extern.
Crearea și modificarea proxy-urilor necesită permisiunea pentru setările magazinului. Adresa destinație, headerele și transformările trebuie stabilite împreună cu persoana care implementează integrarea.
Creează un proxy
- Accesează Setari > API si webhook-uri > Proxy-uri API.
- Apasă Adauga proxy API.
- Completează Denumire interna cu un nume care identifică integrarea.
- În câmpul Endpoint proxy, introdu slug-ul unic. MerchantPro îl afișează
după prefixul
/bridge/. - Completează URL API destinatie cu adresa HTTPS a serviciului extern.
- În Mai multe optiuni, adaugă headerele — metadatele HTTP ale cererii — sau transformările pentru cerere și răspuns numai dacă integrarea le necesită.
- Apasă Salveaza.
Denumirea și slug-ul trebuie să fie unice. Pentru transformări, panoul de control verifică sintaxa Twig, adică a șablonului tehnic folosit pentru transformare, înainte de salvare, dar corectitudinea logicii trebuie testată împreună cu integratorul sistemului extern.
Păstrează tokenurile și valorile sensibile în configurarea proxy-ului. Nu le include în JavaScript-ul public al magazinului și nu publica secretul de semnare.
Folosește secretul de semnare
Pagina Proxy-uri API afișează o acțiune separată pentru copierea secretului de semnare al magazinului. Secretul nu este inclus în datele obișnuite ale listei și este încărcat numai când folosești Copiază secretul de semnare.
Transmite secretul doar sistemului care trebuie să verifice cererile. Pentru algoritmul de semnare și implementarea verificării, folosește documentația proxy-urilor API.
Testează și administrează proxy-ul
După salvare:
- Folosește Previzualizare numai cu o destinație pregătită pentru test și verifică răspunsul primit.
- Confirmă că adresa publică afișată în listă folosește slug-ul dorit.
- Verifică dacă serviciul extern primește headerele și datele așteptate.
- Dezactivează proxy-ul din coloana Status dacă trebuie să întrerupi temporar accesul.
Poți folosi Editeaza pentru a schimba configurația sau Stergere pentru a elimina definiția. Ștergerea poate întrerupe imediat storefrontul ori aplicația care folosește adresa /bridge/slug.
Dacă proxy-ul nu returnează răspunsul așteptat
- Verifică statusul proxy-ului și slug-ul din adresa publică.
- Confirmă adresa HTTPS a destinației și rezultatul afișat de Previzualizare.
- Verifică împreună cu integratorul sistemului extern headerele, credențialele și transformările configurate.
- Testează din nou fără date reale înainte să reactivezi folosirea în storefront.
Dacă serviciul extern respinge cererea sau transformările trebuie ajustate, trimite integratorului sistemului extern adresa publică a proxy-ului, data și ora testului și mesajul primit. Dacă destinația răspunde corect la un test direct, dar răspunsul prin proxy rămâne diferit, contactează echipa de suport MerchantPro și indică denumirea internă a proxy-ului, data și ora testului și mesajul afișat.
Verifică rezultatul
- URL-ul proxy și destinația externă sunt corecte.
- Credențialele nu apar în codul public al magazinului.
- Cererea de test ajunge la serviciul extern și returnează rezultatul așteptat.
- Proxy-urile nefolosite sunt dezactivate sau eliminate numai după verificarea dependențelor.