From drernie at opendarwin.org Tue Dec 12 10:59:10 2006 From: drernie at opendarwin.org (Dr. Ernie Prabhakar) Date: Tue Dec 12 10:59:11 2006 Subject: [uf-rest] WADL: Web application description language References: Message-ID: <39CC40C1-3DCB-427C-BE49-E5C31487972E@opendarwin.org> Hi all, One perennial topic of interest on this list is whether it is possible to create a RESTful analogue of WSDL: a machine-parseable description of the site's API. http://microformats.org/wiki/rest/description Perhaps the best contender I've seen to date is WADL: https://wadl.dev.java.net/ I must confess that I'd prefer something more concise and HTML-ish, but if nothing else WADL seems to thoroughly capture the problem space. Anyone have any direct experience with it? -- Ernie P. Begin forwarded message: From: "Stelios Eliakis" Date: December 12, 2006 9:06:05 AM PST To: rest-discuss Subject: [rest-discuss] wadl I have to mention Web application description language (WADL) https://wadl.dev.java.net/ I do not know if you have seen it but I think that it is a restFull approach of describing resources. It helps me a lot! -- Stelios Eliakis From bosko.milekic at gmail.com Tue Dec 12 12:26:21 2006 From: bosko.milekic at gmail.com (Bosko Milekic) Date: Tue Dec 12 12:26:23 2006 Subject: [uf-rest] WADL: Web application description language In-Reply-To: <39CC40C1-3DCB-427C-BE49-E5C31487972E@opendarwin.org> References: <39CC40C1-3DCB-427C-BE49-E5C31487972E@opendarwin.org> Message-ID: On 12/12/06, Dr. Ernie Prabhakar wrote: > Hi all, > > One perennial topic of interest on this list is whether it is > possible to create a RESTful analogue of WSDL: a machine-parseable > description of the site's API. FWIW personally I prefer convention over such a liberal specification. For instance, the AtomAPI's introspection stuff paired with the conventions that the AtomAPI implies (for example see http://bitworking.org/rfc/draft-gregorio-07.html#rfc.section.5.1.1) seems fine by me. It's also worth noting, just FWIW, that Rails adopts a lot of the conventions specified in AtomAPI w.r.t. accessing resources and collections of resources. -Bosko -- Bosko Milekic http://www.crowdedweb.com/