@shahidh_k An API call (before) API App HTTP request GET /api/user?id=1 HTTP response { "id": 1, "name": "Elmo" } GET /api/address?user_id=1 { "street": "Sesame street", "city": "New York City" }
@shahidh_k An API call (before) Let’s talk to our API developer to help us out. With one API call. HTTP request GET /api/userinfo?id=1 HTTP response { "id": 1, "name": "Elmo" "address": { "street": "Sesame street", "city": "New York City" } }
@shahidh_k An API call (before) Let’s talk to our API developer to help us out. Again. With one API call that takes params HTTP request GET /api/userinfo?id=1&fields=id,name,address.city HTTP response { "id": 1, "name": "Elmo" "address": { "street": "Sesame street" } }
@shahidh_k Key insights #1 Your API models are “graph” like. User: Id Name Address: Street City Orders: Id Product Product: Id Name Photo Brand Brand: Id Name
@shahidh_k Key insights #2 You want to control the data you get User: Id Name Address: Street City Orders: Id Product Product: Id Name Photo Brand Brand: Id Name
@shahidh_k Parameters to your API (after ) Your API calls will have parameters. query { user (id: 1) { id name } } Any field in your query can take arguments in ()
@shahidh_k “Writing” to your API (before) - POST - PUT - DELETE - PATCH HTTP request POST /api/todo { "todo": "Grok GraphQL" } HTTP response 200 { "id": 987 }
@shahidh_k “Realtime” APIs (before) API App Option 1: Polling Client makes repeated requests every X seconds to refetch data. #yuck Option 2: Websockets Server pushes data to the client over websockets. #nightmare
@shahidh_k Sharing/documenting APIs (before) API developer builds API API developer writes documentation Google sheets Postman Swagger You read documentation You start integrating the API Docs are missing, out-of-date, plain wrong
@shahidh_k GraphQL schema: The type-system of your API User: Id Name Address: Street City Orders: Id Product Product: Id Name Photo Brand Brand: Id Name type User { id: Int name: String address: Address } type Address { id: Int street: String city: String }
@shahidh_k Introspection API { __type(name: "todos") { name fields { name } } } Make a GraphQL query to fetch the type information! todos id created_at is_completed text user ...
shahidhk
mosa_siru
yamamuteki
akiroom
takanorig
coconala_engineer
shibuiwilliam
murachiakira
naohachi89
codenote
sat
onlinesalon
tyrmanuz
lauravandoore
aki_iinuma
frogandcode
mongodb
ammeep
samlambert
jonyablonski
michaelherold
lara
stephaniewalter
carmenintech
eileencodes