Pixelpillow College Tour HTTP APIs 

Waaaa tt t?!?! • HTTP als protocol. • Een communica ti elaag tussen twee system. 

HTTP is een… • URL – h tt ps://google.com/search?q=lmgt fy • Methode – POST, PATH, DELETE • Headers – Content-Type: “applica ti on/json” • Body – { “foo”: “bar” } • Status code – 200 OK 

Maar zegt niks over… • Structuur (zoals paden) • Transport (HTML, XML, JSON, etc.) 

Dus: smaakjes! • SOAP • RESTful • JSON-API • GraphQL 

SOAP 

SOAP 

RESTful Stateless – Geen afhankelijkheden tussen opvolgende requests. Decoupled – Geen aannames over gebruik door een client. Cacheable – En dus snel Uniform – Voorspelbaar! 

RESTful requests GET /api/posts ! 200 OK POST /api/posts ! 201 Created GET /api/posts/1 ! 200 OK PATCH /api/posts/12 ! 200 OK DELETE /api/posts/12 ! 410 Gone 

RESTful is niet genoeg… Geen standaard, slechts principes 👎 Geen ondersteuning voor “ac ti es” 🤔 Rela ti onele data is las ti g. 😭 

JSON-API: Best of REST Een standaard! Vanuit de prak ti jk ( fi lters, meta data, etc.) Rela ti es via links en included 

{ "data": [ { "type": "articles", "id": "1", "attributes": { “title": "JSON:API paints my bikeshed!" }, "relationships": { "author": { "links": { "self": "http://example.com/articles/1/relationships/author", "related": "http://example.com/articles/1/author" }, "data": { "type": "people", "id": "9" } }, "comments": { "links": { "self": "http://example.com/articles/1/relationships/comments", "related": "http://example.com/articles/1/comments" }, "data": [ { "type": "comments", "id": "5" }, { "type": "comments", "id": "12" } ] } }, "links": { "self": "http://example.com/articles/1" } }], "included": [{ "type": "people", "id": "9", "attributes": { "firstName": "Dan", "lastName": "Gebhardt", "twitter": "dgeb" }, 

{ "data": [ { "type": "articles", "id": "1", "attributes": { "title": "JSON:API paints my bikeshed!" }, "relationships": { "author": { "links": { "self": "http://example.com/articles/1/relationships/author", "related": "http://example.com/articles/1/author" }, "data": { "type": "people", "id": "9" } }, "comments": { "links": { "self": "http://example.com/articles/1/relationships/comments", "related": "http://example.com/articles/1/comments" }, "data": [ { "type": "comments", "id": "5" }, { "type": "comments", "id": "12" } ] } }, "links": { "self": "http://example.com/articles/1" } }], "included": [{ "type": "people", "id": "9", "attributes": { "firstName": "Dan", "lastName": "Gebhardt", "twitter": "dgeb" }, 

JSON:API hee ft geen… Geen ondersteuning voor “ac ti es” 🤔 (bijv. het favoriten van een resource) Is niet self-documen ti ng… 📚 

GraphQL Alles is een graaf™ Mutations en Queries 

GraphQL Playground!!! https://www.apollographql.com/docs/apollo-server/v2/testing/graphql-playground/ 

Can’t have your cake and eat it too. Paradigma sluit niet aan bij onze manier van backends bouwen. 

Vragen? 038 750 3491 [email protected]