Recommended
More Related Content
What's hot
What's hot (20)
Similar to Diseño y Desarrollo de APIs
Similar to Diseño y Desarrollo de APIs (20)
Recently uploaded
Recently uploaded (20)
Diseño y Desarrollo de APIs
- 1. DISEÑO Y DESARROLLO DE APIS Workshop de http://cdn.traveler.es/uploads/images/thumbs/201408/9_locuras_del_skyline_de_londres_737368666_1200x798.jpg #PosadasTechIng. Raúl Neis
- 4. http://www.teameliteconstruction.co.uk/wp-content/uploads/2014/03/house-base-1.jpg Operating System
- 5. // Linux <3 open(…) // Windows NtOpenFile(…) Operating System API
- 7. int printf(const char* formato, …) int fopen(const char* pathname, int flags); Libraries API
- 9. public interface Iterator<E> { boolean hasNext(); E next(); void remove(); } Framework API
- 11. class Box { public void setVolume(double volume) { ... } } Application API
- 25. Request
- 26. GET / HTTP/1.1 Host: google.com Accept: text/html,application/xml Request
- 27. GET / HTTP/1.1 Host: google.com Accept: text/html,application/xml Request
- 28. GET / HTTP/1.1 Host: google.com Accept: text/html,application/xml Request
- 29. GET / HTTP/1.1 Host: google.com Accept: text/html,application/xml Request
- 30. Response
- 31. GET / HTTP/1.1 Host: google.com Accept: text/html,application/xml Response
- 32. GET / HTTP/1.1 Host: google.com Accept: text/html,application/xml HTTP/1.1 200 OK Content-Type: text/html <!doctype html><html itemscope=""itemtype="http://schema.org/... Response
- 33. GET / HTTP/1.1 Host: google.com Accept: text/html,application/xml HTTP/1.1 200 OK Content-Type: text/html <!doctype html><html itemscope=""itemtype="http://schema.org/... Response
- 34. GET / HTTP/1.1 Host: google.com Accept: text/html,application/xml HTTP/1.1 200 OK Content-Type: text/html <!doctype html><html itemscope=""itemtype="http://schema.org/... Response
- 35. GET / HTTP/1.1 Host: google.com Accept: text/html,application/xml HTTP/1.1 200 OK Content-Type: text/html <!doctype html><html itemscope=""itemtype="http://schema.org/... Response
- 36. 200 - Ok 201 - Created 204 - No Content HTTP Status 2xx
- 37. 301 - Moved Permanently 302 - Found 304 - Not Modified HTTP Status 3xx
- 38. 400 - Bad Request 401 - Unauthorized 403 - Forbidden 404 - Not Found 409 - Conflict HTTP Status 4xx
- 39. 500 - Internal Server Error 503 - Service Unavailable HTTP Status 5xx
- 41. GET / HTTP/1.1 Host: google.com Accept: text/html,application/xml HTTP/1.1 200 OK Content-Type: text/html <!doctype html><html itemscope=""itemtype="http://schema.org/... Response
- 42. Content-Type
- 43. (MIME)
- 47. {JSON}
- 48. { "user": { "id": 1, "name": "John Doe", "numbers": [1, 2, 3] } } JSON
- 49. Apps
- 50. Web Apps
- 51. Mobile Apps
- 52. Desktop Apps
- 53. Backends
- 58. Resource
- 64. /posts ⇒ [ {…}, {…}, {…}, …] Collection Resource
- 66. /posts/abc123 ⇒ {…} Instance Resource
- 67. Behaviour
- 68. Behaviour GET - POST - PUT - DELETE
- 69. POST
- 71. POST /posts { "title": "Api Workshop!", "body": "..." } POST
- 72. POST /posts { "title": "Api Workshop!", "body": "..." } Response HTTP 201 Created Location: /posts/abc123 POST
- 73. GET
- 75. GET /posts Response HTTP 200 Ok [ … ] GET (Collection)
- 76. HTTP 200 Ok [ { "self": "/posts/abc123", "title": "Api Workshop!", "body": "..." }, { "self": "/posts/efg456", "title": "...", "body": "..." }, … ] GET (Collection)
- 78. HTTP 200 Ok { "self": "/posts/abc123", "title": "Api Workshop!", "body": "..." } GET (Instance)
- 79. HTTP 200 Ok { "self": "/posts/abc123", "title": "Api Workshop!", "body": "...", "comments": [ { "self": "/posts/abc123/comments/1" }, { "self": "/posts/abc123/comments/2" }, { "self": "/posts/abc123/comments/3" } ] } GET (Instance)
- 80. DELETE
- 82. DELETE /posts/abc123 Response HTTP 204 No Content DELETE
- 83. PUT
- 84. PUT /posts/abc123 { "title": "Updated Api Workshop!", "body": ... } PUT (update)
- 85. PUT /posts/abc123 ... Response HTTP 200 Ok { "self": "/posts/abc123", "title": "Updated Api Workshop!", "body": "..." } PUT (update)
- 86. PUT /posts/abc123 ... Response HTTP 204 No Content PUT (update)
- 88. POST /posts/abc123 { "title": "NEW Api Workshop!" } POST (partial update)
- 89. POST /posts/abc123 { "title": "NEW Api Workshop!" } Response HTTP 200 Ok { "self": "/posts/abc123", "title": "NEW Api Workshop!", "body": "..." } POST (partial update)
- 90. PATCH
- 92. BASE URL
- 94. HTTPS, please
- 96. VERSIONING
- 98. MEDIA TYPES
- 100. Content-Type: application/json Content-Type: application/user+json Content-Type: application/post+json Media types
- 102. LETTER CASES
- 103. { "self": "/users/123", "user_name": "John Doe", } { "self": "/users/123", "userName": "John Doe", } Letter cases
- 104. TIMESTAMPS
- 105. ISO 8601
- 108. ERRORS
- 110. HTTP 409 Conflict { "status": 409, "message": "The username is taken." } Errors
- 111. HTTP 409 Conflict { "status": 409, "message": "The username is taken.", "devMessage": "The field 'username' must be unique.", "property": "username", "info": "https://api.dev/info/asb32321213" } Errors
- 112. RESPONSE BODY
- 113. HTTP 200 Ok { "self": "/posts/abc123", "title": "NEW Api Workshop!", "body": "..." } Response body
- 114. HTTP 200 Ok { "self": "/posts/abc123", "title": "NEW Api Workshop!", "body": "..." } ?_body=false Response body
- 115. REFERENCE EXPANSION
- 116. GET /users/123 { "self": "/users/123", "name": "John Doe", "posts": [ { "self": "/posts/abc123" }, { "self": "/posts/def456" } ] } Reference expansion
- 117. GET /users/123?expand=posts { "self": "/users/123", "name": "John Doe", "posts": [ { "self": "/posts/abc123", "title": "...", ... }, { "self": "/posts/def456", "title": "...", ... } ] } Reference expansion
- 119. GET /users/123 { "self": "/users/123", "name": "John Doe", "posts": [ { "self": "/posts/abc123" }, { "self": "/posts/def456" } ] } Partial representation
- 120. GET /users/123?fields=name,posts(title) { "self": "/users/123", "name": "John Doe", "posts": [ { "self": "/posts/abc123", "title": "..." }, { "self": "/posts/def456", "title": "..." } ] } Partial representation
- 122. GET /users/123?fields=name,posts(title) { "self": "/users/123", "name": "John Doe", "posts": [ { "self": "/posts/abc123", "title": "..." }, { "self": "/posts/def456", "title": "..." } ] } Partial representation
- 124. GET /users/123?fields=name,posts(title) { "self": "/users/123", "name": "John Doe", "posts": [ { "self": "/posts/abc123", "title": "..." }, { "self": "/posts/def456", "title": "..." } ] } Partial representation
- 126. TYPE SYSTEM
- 127. type Post { title: String body: String comments: [Comment] } Type system
- 128. type Post { title: String body: String comments: [Comment] } type Comment { post: Post text: String } Type system
- 129. type Post { title: String body: String comments: [Comment] } type Comment { post: Post text: String } Type system
- 130. QUERIES
- 132. { posts { title comments { text } } } Queries { "data": [ { "title": "Api Workshop!", "comments": [ { "text": "..." }, { "text": "..." } ] } // ... ] }
- 133. { posts(id: "abc123") { title comments { text } } } Queries { "data": { "title": "Api Workshop!", "comments": [ { "text": "..." }, { "text": "..." } ] } }
- 134. REQUESTS
- 135. /graphql Endpoint
- 140. APIs ♥
- 141. DISEÑO Y DESARROLLO DE APIS Workshop de http://cdn.traveler.es/uploads/images/thumbs/201408/9_locuras_del_skyline_de_londres_737368666_1200x798.jpg #PosadasTechIng. Raúl Neis