rest/examples: Difference between revisions

From Microformats Wiki
Jump to navigation Jump to search
Line 23: Line 23:
   escaped <tags>
   escaped <tags>


=== [Example #2 (url)] ===
=== [http://images.amazon.com/images/G/media/i3d/01/associates/ecs-dg-20051005.pdf Amazon E-Commerce] ===
pre
 
  escaped <tags>
Not a very good example, as they only have a single URI for the "REST" API, and do everything with url-encoding.


== Existing Practices ==
== Existing Practices ==

Revision as of 18:39, 13 October 2005

XHTML-REST Examples

These are some examples of how people are currently implementing REST web services (usually in XML), to provide some context for how best to implement them in XHTML.

The Problem

Quoting the wikipedia REST article:

In general, however, REST for data does not yet have a generally-accepted, standard format corresponding to HTML for documents, so each REST client must be custom-written to deal with XML at a fairly low level, and crawling XML data over REST is difficult (since it is not always easy to identify links). Proposals for a standard, generic format for use with REST based systems have included RDF, XTM, Atom, RSS (in its various flavours), and Plain Old XML (POX) with XLink to handle links

In short, there isn't a clean design pattern for the optimal way to encode and use REST, which is precisely the sort of thing a microformats approach can provide.

Participants

Real-World Examples

Links to public web pages, either popular or insightful

[Example #1 (url)]

http://ietf.org/internet-drafts/draft-sayre-atompub-protocol-basic-03.txt

pre
 escaped <tags>

Amazon E-Commerce

Not a very good example, as they only have a single URI for the "REST" API, and do everything with url-encoding.

Existing Practices

  • Summary of common patterns discovered
  • Other attempts to solve The Problem

Proposal

[1]

    • - proposal
    • -microformat

See Also


  • Normative references for tags used