Què és una API REST? Li diu alguna cosa per aturar-se o fer una pausa? És una API RESTful un programa gandul o un que inicia un estat de descans? Si esteu interessats en la web i en com funcionen les diverses tecnologies que hi ha al darrere, voldreu saber sobre l’API RESTful.
Una API és una interfície de programació d’aplicacions. Una API pot ser moltes coses per a molts programadors, però és essencialment un intermediari que permet connectar un programa a un altre. Molts programadors i desenvolupadors amagaran el seu codi bàsic per impedir que altres robin tot el seu treball dur. Si volen que altres programes funcionin amb el seu programa, també han de posar algun codi disponible per permetre aquesta interacció. És allà on entren les API. Un desenvolupador pot crear API que permetin que altres programes interfereixin amb la seva creació i proporcionin funcions i interaccions addicionals.
Una API s’escriurà amb una estructura determinada formatada d’una manera determinada que el recurs pugui comprendre i que no utilitza massa recursos. Molts llocs web, programes i plataformes utilitzen API. Facebook els té, YouTube els utilitza, Google Maps els té, Android i iOS els utilitzen i el programari més destacat tindrà algun tipus d'interfície de programació. És una bona manera d’afegir valor i funcions sense mostrar al món com es combina el vostre programa.
Com s’utilitzen les API?
Per exemple, digueu que voleu crear un conjunt de filtres de càmeres per a un telèfon. En lloc de crear la vostra pròpia aplicació de càmera, faríeu servir l'API de càmera d'Apple o d'Android per utilitzar la càmera. L’alternativa seria crear un programari de càmera completament nou per a cada sistema operatiu del telèfon, que té molta feina. En lloc d'això, només cal crear una API que pugui comunicar-se amb el programari de la càmera existent i enviar les dades del filtre cap a i des d'aquest.
Les API també es poden utilitzar per accedir als recursos del sistema, la interfície amb altres sistemes, proporcionar funcions d’afegiment de valor als navegadors i tot allò bo. Si només recordeu que una API és un fragment de codi que parla amb altres programes, haureu d’estar bé.
Un altre exemple seria Google Maps. Si voleu afegir un Google Map al vostre lloc web on es mostri la vostra ubicació, configureu una API de Google Maps amb una consulta HTTP GET per treure el mapa de Google. D’aquesta manera, obtindreu el que voleu sense que Google hagi de fer res ni permetre l’accés als interns de la seva plataforma de mapeig.
Si utilitzeu una API, els servidors de Google Maps poden satisfer milions de consultes en un període de temps curt sense sobrecarregar el servidor de mapes. Les consultes de l’API s’estructuraran correctament per tal de poder satisfer-se utilitzant els menys recursos. L’API RESTful garanteix que no es pot escriure res a la base de dades i no deixa rastre, deixant que el servidor de mapes passi a la següent consulta.
API RESTful
REST significa representació de transferència estatal representativa. Una API RESTful s'utilitza per transferir dades d'un recurs a un client. A tall d’exemple, un motor de cerca utilitza un tipus d’API RESTful. Escriviu un terme de cerca i el motor consulta les servidores. Els servicis transmeten les dades corresponents al navegador perquè el pugueu utilitzar. Així funciona RESTful API.
Ja sabeu que una API permet als programes externs la interfície amb determinats altres programes. Una API RESTful permet a un programa independent comunicar-se amb una base de dades completament separada, com en l'exemple del motor de cerca anterior.
El que fa que una API RESTful funcioni és que està sense estat i en memòria cau. Sense estat significa que la consulta realitzada per una API RESTful no té cap impacte sobre la base de dades. La consulta no està (sempre) registrada, no s’emmagatzema res a la base de dades i no es pot escriure a la base de dades. És essencialment de només lectura.
Ser emmagatzemat en memòria cau significa que el client de l'API pot emmagatzemar la informació per a un ús futur, de manera que no ha de consultar la base de dades cada vegada.
Per a la web, l'API probablement usarà el mètode HTTP per processar una sol·licitud. Els mètodes HTTP comuns són GET, POST, PUT i DELETE. A l'exemple del motor de cerca, l'API RESTful utilitzaria el mètode HTTP per obtenir les vostres dades de consulta de la base de dades del motor de cerca per mostrar els resultats de la cerca.
Un altre exemple seria la cerca d’usuaris de Twitter. Si introduïu l’URL www.twitter.com/realDonaldTrump a un navegador, el navegador utilitzarà HTTP per obtenir les dades de Donald Trump de Twitter i mostrar-vos-les. Com que els noms d’usuari de Twitter són únics, la consulta retornarà els detalls al vostre navegador.
L’API RESTful és una forma força elegant de compartir informació sense afectar el rendiment del servidor ni cedir-ne massa. Aquest tutorial només rasca la superfície del seu funcionament i la seva integració al web, però us ha de donar una idea bàsica del que passa.
