This document introduces RESTful web services. It discusses the REST architectural style and its key principles: using HTTP methods explicitly to manipulate resources, being stateless, using directory structure-like URIs, and transferring resources with any valid MIME type. The principles are illustrated with examples of adding, retrieving, updating, and deleting resources using the HTTP methods POST, GET, PUT, and DELETE.

1. Introduction to RESTful Webservice
Eftakhairul Islam
Jr. Software Engineer
Right Brain Solution Ltd.
email: eftakhairul@gmail.com
web: http://eftakhairul.com

2. What is Webservice?
phpXpert Seminar 2011 2

3. Webservice Design Models

XML RPC

SOAP

REST
phpXpert Seminar 2011 3

4. Inside RESTful Webservice?

Not Techology and not even protocol

Software archetechtural principle

Resouces transfer over HTTP
phpXpert Seminar 2011 4

5. Basic Design Principles Of REST
1. HTTP methods explicitly
2. Be stateless
3. Directory structure­like URIs
4. Transfer resources by any valid MIME type
supported by the web service.
phpXpert Seminar 2011 5

6. HTTP Methods Explicitly
Add Resources
POST http://api.linkedin.com/v1/people/123/friends
Content­Type: application/xml
<friend uri=“urn:linkedin:v1:people/888”/>
phpXpert Seminar 2011 6

7. HTTP Methods Explicitly
Retrieve Resources
GET http://api.linkedin.com/v1/people/123
Output:
<?xml version="1.0" encoding="UTF­8"?>
<person>
<id>123</id>
<first­name>Sakib</first­name>
<last­name>Stein</last­name>
<connections total="200">
…
</person>
phpXpert Seminar 2011 7

8. HTTP Methods Explicitly
Update Resources
PUT http://api.linkedin.com/v1/people/123
Content­Type: application/xml
<person>
<name>Sakib Mahmud</name>
<best­friend uri=“urn:linkedin:v1:people/999”/>
<photo xsi:nil=“true”/>
</person>
phpXpert Seminar 2011 8

9. HTTP Methods Explicitly
Delete Reasource
DELETE http://api.linkedin.com/v1/people/123/friends/456
Output:
Friend:456 will be deleted from linkedin.
phpXpert Seminar 2011 9

10. Be Stateless
Stateful design (Non­REST):
previousPage++
Client Server nextPage = previousPage
return nextPage
phpXpert Seminar 2011 10

11. Be Stateless
Stateless design (REST):
GET /resources/?page=2 HTTP/1.1
<?xml version= ”1.0” ?>
<rsp page=”2” nextPage=”3”>
Client <resource id = ''11/> Server
<resource id = ''12”/>
. ..
</rsp>
phpXpert Seminar 2011 11

12. Directory Structure­like URIs
http://example.com/topics/{topic_name}
http://graph.facebook.com/10150224661566729
http://twitter.com/statuses/user_timeline.xml?
id=eftakhairul
phpXpert Seminar 2011 12

13. Transfer Resources By Any Valid MIME Type
Mostly Used

XML

JSON

XHTML
Any other valid contend type
phpXpert Seminar 2011 13

14. Thank You
Please Stop Software Piracy, Save Developer
Use FOSS or Genuine Software
phpXpert Seminar 2011 14