ghjuventù
Cù pochi clicchi nantu à un desktop o un dispositivu, unu pò cumprà, vende o pubblicà qualcosa, in ogni momentu. Esattamente cumu succede? Cumu faci nantu à u corsu andà da quì à quì? L'eroi micca ricunnisciutu hè l'API.
Cosa hè una API?
API significa an INTERFACE DI PROGRAMMAZIONE APPLICAZIONE. Una API esprime un cumpunente di software, e so operazioni, inputs, outputs, è tipi sottostanti. Ma cumu si spiegà l'API in inglese chjaru? L'API funziona cum'è un messaggeru chì trasferisce a vostra dumanda da una applicazione è vi dà a risposta.
Esemplariu 1: Quandu cercate i voli in linea. Interagisce cù u situ web di a compagnia aerea. U situ web detalla i posti è u costu di u volu in quella data è ora particulare. Sceglite u vostru pastu o posti, bagaglii, o richieste di animali.
Ma, sè ùn site micca aduprendu u situ web direttu di a compagnia aerea o si usa un agentu di viaghju in linea chì combina dati da parechje compagnie aeree. Per uttene l'infurmazioni, una applicazione interagisce cù l'API di a compagnia aerea. L'API hè l'interfaccia chì porta dati da u situ web di l'agente di viaghju à u sistema di a compagnia aerea.
Piglia ancu a risposta di a compagnia aerea è rimette subitu. Questu facilita l'interazzione trà u serviziu di viaghju è i sistemi di a compagnia aerea per riservà u volu. L'API implica una libreria per rutine, strutture di dati, classi d'ogetti è variabili. Per esempiu, servizii SOAP è REST.
Esemplariu 2: Best Buy rende una offerta speciale di prezzi di u ghjornu dispunibule attraversu u so situ web. Questa stessa dati hè in a so applicazione mobile. L'app ùn si preoccupa micca di u sistema di prezzu internu - pò chjamà l'API Deal of the Day è dumandate, chì hè u prezzu speciale? Best Buy risponde cù l'infurmazioni dumandate in un formatu standard chì l'app mostra à l'utilizatore finale.
Esempiu 3: L'API per i social media sò cruciali. L'utilizatori ponu accede à u cuntenutu è mantene u numeru di cunti è password chì tenenu traccia di bassu, cusì ponu mantene e cose simplici.
- API Twitter: Interagisce cù a maiò parte di e funzioni di Twitter
- API di Facebook: Per pagamenti, dati d'utilizatori è login
- API Instagram: Tag utilizatori, vede e foto di tendenza
E l'API REST & SOAP?
sapone e REST aduprà un serviziu chì cunsuma API, cunnisciutu cum'è Web API. U serviziu Web ùn hè micca dipendente di alcuna cunniscenza previa di l'infurmazioni. SOAP hè un protocolu di serviziu web chì hè ligeru indipendente da a piattaforma. SOAP hè un protocolu di messageria basatu in XML. A cuntrariu di u serviziu web SOAP, u serviziu Restful usa l'architettura REST, custruita per a cumunicazione puntu à puntu.
U serviziu web SOAP
- SOAP Sender - crea è trasmette un missaghju.
- SOAP Receiver - riceve è processa u messagiu.
- SOAP Intermediary - riceve è processa blocchi di header.
Serviziu Web RESTful
Trasferimentu di u Statu Rappresentanti (REST) hè in relazione cù a relazione trà u cliente è u servitore è cumu u processu statale. L'architettura di u restu, un Servitore REST furnisce l'accessu di risorse à u cliente. Rest gestisce a lettura è mudificà o scrive e risorse. L'URI (Uniform Identifier) identifica e risorse per cuntene un documentu. Questu catturà u statu di risorsa.
REST hè più ligeru di l'architettura SOAP. Analizeghja JSON, una lingua leggibile da l'omu chì permette a spartera di dati è più faciule d'utilizà e dati, invece di XML utilizatu da l'architettura SOAP.
Ci sò parechji principii per u disignu di u Serviziu Web Restful, chì sò:
- Addressability - Ogni risorsa deve avè almenu un URL.
- Apatridia - Un serviziu Restful hè un serviziu senza statu. Una dumanda hè indipendente da qualsiasi dumande passate da u serviziu. HTTP hè da cuncepimentu un protokollu senza statu.
- Cacheable - Dati marcati cum'è magazzini cacheable in u sistema è riutilizate in u futuru. Cum'è a risposta à a stessa dumanda invece di pruduce i stessi risultati. E restrizioni di cache permettenu a marcatura di dati di risposta cum'è cacheable o micca cacheable.
- Interfaccia uniforme - Permette una interfaccia cumuni è standardizata per utilizà per l'accessu. L'usu di una cullizzioni definita di metudi HTTP. Attentu à questi cuncetti assicura chì l'implementazione REST hè ligera.
Vantaghji di REST
- Aduprà un furmatu più simplice per i missaghji
- Offre una efficienza più forte à longu andà
- Supporta a cumunicazione senza statu
- Aduprate standard HTTP è grammatica
- I dati sò dispunibuli cum'è una risorsa
Svantaghji di REST
- Falla in i normi di serviziu Web cum'è Transazzioni di Sicurezza etc.
- E dumande REST ùn sò micca scalabili
REST vs SOAP Paragone
Differenze trà i servizii web SOAP è REST.
Serviziu Web SOAP | Rest Web Service |
Richiede una carica di input pesante rispetto a REST. | REST hè ligeru perchè usa URI per i formi di dati. |
U cambiamentu in i servizii SOAP spessu porta à un cambiamentu significativu in u codice da u cliente. | U codice di u cliente ùn hè micca affettatu da u cambiamentu di i servizii in a pruvista web REST. |
U tipu di ritornu hè sempre u tipu XML. | Fornisce versatilità in quantu à a forma di i dati restituiti. |
Un protocolu di messagiu basatu in XML | Un protocolu architettonicu |
Richiede una biblioteca SOAP à a fine di u cliente. | Nisun supportu di biblioteche necessariu tipicamente utilizatu nantu à HTTP. |
Supporta WS-Security è SSL. | Supporta SSL è HTTPS. |
SOAP definisce a so propria sicurità. | I servizii web RESTful ereditanu e misure di sicurezza da u trasportu sottostante. |
Tipi di Politiche di Rilascio di API
Politiche di rilascio per l'API sò:
Politiche di liberazione privata:
L'API hè solu dispunibule per l'usu internu di a cumpagnia.
Politiche di liberazione di i partenarii:
L'API hè dispunibule solu per i partenarii cummerciale particulari. L'imprese ponu cuntrullà a qualità di l'API per via di u cuntrollu di quale pò accede.
Politiche di liberazione publica:
L'API hè per usu publicu. A dispunibilità di e pulitiche di liberazione hè dispunibule per u publicu. Esempiu: Microsoft Windows API è Apple's Cocoa.
cunchiusioni
L'API sò prisenti in ogni locu, sia riservà un volu o ingaghjate cù l'applicazioni di e social media. L'API SOAP hè basata nantu à cumunicazioni XML, si differenzia da l'API REST in quantu ùn hè micca bisognu di cunfigurazione speciale.
Designing Rest Web services deve aderisce à certi cuncetti, cumprese l'indirizzabilità, l'apatridia, a cacheabilità è una interfaccia standard. I reguli di liberazione di l'API ponu esse divisi in trè categurie: API privati, API partenarii è API publichi.
Grazie per leghje stu articulu. Scuprite u nostru articulu nantu à una Guida API Security 2022.
