Ce înseamnă API?

O prescurtare API pentru Application Programming Interface înseamnă un set de coduri de funcții care permit aplicațiilor să acceseze date specificate și să interacționeze cu componente externe ale aplicațiilor software, sisteme de operare sau microservicii.

Pentru a simplifica, un API oferă un răspuns utilizator unui sistem și trimite răspunsul sistemului înapoi unui utilizator. Dați clic pe „adăugați în coș”; un API spune site-ului că ați adăugat un produs în coș; site-ul vă pune produsul în coș, iar coșul dvs. este actualizat.

Este posibil să auziți că termenul „microservicii” apare în legătură cu API. Acestea însă nu sunt la fel. Microserviciile sunt un stil sau o arhitectură care împarte funcționalitatea într-o aplicație web. În timp ce API este cadrul prin care dezvoltatorii interacționează cu o aplicație web. Microservicii pot de fapt utilizați API pentru a comunica între fiecare.

API-ul permite unui dezvoltator să facă un anumit „apel” sau „cerere” pentru a trimite sau a primi informații. Această comunicare se face folosind un limbaj de programare numit „JSON”. Poate fi folosit și pentru a face o acțiune definită, cum ar fi actualizarea sau ștergerea datelor. Există patru metode de bază de solicitare care pot fi făcute cu API:

GET – Adună informații (tragerea tuturor codurilor de cupon)

PUT – Actualizează date (Actualizează prețul produsului)

POST – creează (crearea unei noi categorii de produse)

DELETE – (Ștergerea unei postări de blog)

Ce este JSON și de ce este utilizat?

JSON (JavaScript Object Notation) este folosit pentru a reprezenta date pe un server. Este destul de ușor de citit de oameni și ușor de înțeles pentru mașini/aplicații. Să ne uităm la un exemplu de JSON dintr-un produs pe BigCommerce:

Acest lucru este ușor de înțeles deoarece este afișat în perechi cheie/valoare, cu cheia în stânga și o valoare în dreapta. Cheile sunt un obiect fix definit de aplicație și vor rămâne aceleași ca în „categorie”. În timp ce valorile vor fi unice, cum ar fi „cămăși”.

Ce este o solicitare API?

Există mai multe componente ale unei solicitări API pentru ca aceasta să funcționeze. Să trecem peste acestea individual și cum pot fi folosite pentru a construi o solicitare.

Ce este Endpoint?

Există două părți cheie ale unui punct final care sunt utilizate atunci când se face o solicitare API. Una dintre ele este adresa URL. BigCommerce folosește https://api.bigcommerce.com/stores/ ca adresă URL pentru toate solicitările API. Aceasta poate arăta ca o adresă URL obișnuită, dar dacă îl conectați la un browser web, veți primi un mesaj de eroare 404.

A doua parte este calea. Calea va varia în funcție de ceea ce încercați să realizați. Puteți găsi o listă a căilor disponibile pentru BigCommerce, vizitând documentația noastră pentru dezvoltatori: https://developer.bigcommerce.com/api-reference. Pentru acest exemplu vom folosi calea produsului care este /v3/catalog/products.

Când punem împreună aceste două părți, obținem un punct final complet https://api.bigcommerce.com/stores/{store_hash}/v3/catalog/products. Acum s-ar putea să vă spuneți „Ce este {store_hash}?” „De unde a venit?” Aceasta este ceea ce se numește variabilă. Variabilele sunt componente unice pentru un punct final și vor varia în funcție de informațiile magazinului dvs. Puteți identifica o variabilă după parantezele deschise și închise „{ }”.

Ce este antetul?

Anteturile oferă informații clientului și serverului. Exemple obișnuite de antet ar fi acreditările de autentificare, cum ar fi „Auth Token” sau „Client ID”. Aceste acreditări vă sunt furnizate automat atunci când creați un cont API. Un alt antet comun este denumit „Tipul de conținut”, care informează serverul despre ce tip de conținut va fi trimis. De exemplu, un tip de conținut utilizat în mod obișnuit este „application/json”, ceea ce anunță serverul că trimitem date JSON.

Ce este Metoda?

Metodele sunt acțiunile întreprinse la trimiterea unei cereri. Gândiți-vă la început când am discutat despre GET, PUT, POST și DELETE. Acestea sunt toate metodele API.

Ce sunt datele?

Datele de solicitare, denumite în mod obișnuit „corp”, sunt informații care vor fi fie trimise, fie returnate de către un server. În discuția anterioară despre JSON, puteți vedea un exemplu de date API. Corpul unei cereri va necesita uneori informații specifice înainte de a putea fi livrată. Un exemplu în acest sens este, dacă editați un singur produs, ID-ul produsului va fi necesar înainte de a putea fi efectuată orice modificare.

Află mai multe aici.