The document discusses REST (REpresentational State Transfer) APIs and how to build a simple RESTful API using ASP.NET Web API. Some key points covered include: - The five principles of REST including giving every resource an ID and linking resources together. - HTTP methods like GET, POST, PUT, and DELETE should be used to perform CRUD operations on resources. - ASP.NET Web API is well suited for building HTTP services that return data in formats like JSON and XML, while ASP.NET MVC is better for full web applications that return both views and data. - Web API uses different parameter bindings - queries from the URL, bodies from request payloads. Routing maps HTTP

1. REST (RESTful) API

2. What is REST?

3. The five key principles are:
• Give every “thing” an ID
• Link things together
• Use standard methods
• Resources with multiple representations
• Communicate statelessly

4. HTTP methods

5. Without REST

6. With REST

7. Build simple RESTful API
• /getAllMembers
• /getAllCertificatedMembers
• /getMember/1
• /newMember
• /saveMember
It’s not OK

8. It’s OK
• POST /Members — Creation of a new member
• GET /Members — A list of all members in the system
• PUT /Members — An update to the all members
• DELETE /Members — Delete all members
• POST /Members/12345 — Return error (member 12345 are
created)
• GET /Members/12345 — Show member with ID 12345
• PUT /Members/12345 — Edit member with ID12345
• DELETE /Members/12345 — Delete

9. Hide the difficult method of the mark “?”
• GET /members?age=20&city=VN&location=park
• POST /members?age=25&city=VN

10. Support for multiple formats
Like this :
• /members.json
• /members/1234.json
Or support multiple type of
clients :
• /members.ios
• /members/1234.web

11. ASP.NET WEB API

12. Controller vs ApiController
Controller ApiController

13. Controller vs ApiController
MVC Controller Default Route
API Controller Default Route

14. Asp.Net Web API VS Asp.Net MVC
Asp.Net Web API
• to create HTTP services with
easy way that returns only data
• returning data in particular
format like JSON,XML
• the request are mapped to the
actions based on HTTP verbs
Asp.Net MVC
• to create web applications that
returns both views and data
• only return data in JSON format
• it is mapped to actions name.

15. Web API Parameter Bindings
• From Query-String: Using Model Binding
• From Body: Using different data formats like JSON, XML.

16. Routing

17. URL: localhost:3333/test/users/11/tweets

19. Status Code