1. Drupal Web Services
Darren Mothersele

2. Drupal Web Services
Uses of web services
Classifications of web services
Example web service
Types of web services in Drupal

3. Websites
Web apps

4. Websites, web apps +
Syndication
Interoperability
Outsource complexity
Reuse application components
Mashups and unforeseen...

5. Flickr
Google AdWords
Google Maps
hostip.info
NOAA Weather Service
Yahoo Geocoding
Yahoo Local Search

10. iPhone app

11. Classification of web services

13. XML-RPC

15. REST - resource oriented approach...
Method information goes in the HTTP method
Scoping information goes in the URL

16. HTTP methods

17. HTTP error codes
If you get 200 then all is ok.
If you get 3xx 4xx 5xx then something went wrong.
3xx = it's moved
4xx = client error
5xx = server error
404 = not found
418 = i'm a teapot
500 = internal server error
503 = service unavailable

18. REST example - Amazon S3
Amazon S3 based on two concepts:
Bucket
name
Object
parent bucket
value (the data)
key (name)
metadata (key/value pairs)

19. REST example - Amazon S3
Resources:
List of your buckets
http://s3.amazonaws.com/
A bucket
http://s3.amazonaws.com/{bucketname}/
An object
http://s3.amazonaws.com/{bucketname}/{objectname}

20. REST example - Amazon S3
Methods:

21. Types of web service in Drupal
Blog API
Views Datasource
(read only)
Services v3 Services v2
Views Atom
(read only)

22. Views Datasource
Multiple data formats
RDF, XML, JSON,
Configurable using awesome power of Views...

25. http://tagging.darrenmothersele.com/node/42/

26. http://tagging.darrenmothersele.com/node/42/json

27. Views Atom
Style plugin
Alternative Feed style that generates Atom not RSS
RDFNode Row style plugin
Serializes arbitrary node to XML, including CCK fields
Useful with Feeds Atom to move content between Drupal sites.

29. http://tagging.darrenmothersele.com/node/42/atom

30. Services v3 - the future
Fully RESTful web services now possible in Drupal

31. REST on a node
CRUD
create: POST /node
read: GET /node/1
index: GET /node
update: PUT /node/1
delete: DELETE /node/1

32. Services 3 extensions to CRUD
Actions, eg:
POST /node/publish_my_drafts
Targeted actions, eg:
POST /node/1/publish
Relationships, eg:
GET /node/1/comments

33. Response formats
XMLRPC returns XML
JSONRPC returns JSON
REST format agnostic:
http://example.com/node/1.xml
returns XML
http://example.com/node/1.json
returns JSON
http://example.com/node/1.php
returns serialized-PHP

34. Links
Services
http://drupal.org/project/services
Views Datasource
http://drupal.org/project/views_datasource
Views Atom
http://drupal.org/project/views_atom
Hyper Text Coffee Pot Control Protocol (HTCPCP/1.0)
http://tools.ietf.org/html/rfc2324