Generating WADL for REST

[balakumar1]

Hi,

One of our customers need WADL file for the ServiceNow REST service.

Is it possible to generate?

Regards,

Bala

[Daryll Conway]

I'm not aware of WADL within Service Now for REST but with SOAP you can use WSDL so it seems odd there is no documentation for the use or support of WADL.

Let me know if you find anything I'd be interested to know myself.

[Daryll Conway]

Would using the WSDL not give you what you need?

[balakumar1]

WSDL is to define SOAP (Isn't it?). But the people who want to retrieve data from the system use REST instead.

[tony_barratt]

Hi Bala,

Yes it is 🙂

The W3C has made a formal recommendation for a REST documentation to be based on WSDL 2.0.

Here is a quote from the IBM article:

Describe REST Web services with WSDL 2.0

..

Introduction

The term Web services is typically associated with operation- or action-based services using SOAP and the WS* standards, such as WS-Addressing and WS-Security. The term REST Web services generally refers to a resource-based Web services architecture that uses HTTP and XML. Each of these architectural Web service styles has its place, but until recently, the WSDL standard didn't equally support both styles. The WSDL 1.1 HTTP binding was inadequate to describe communications with HTTP and XML, so there was no way to formally describe REST Web services with WSDL. The publication of WSDL 2.0, which was designed with REST Web services in mind, as a World Wide Web Consortium (W3C) recommendation means there is now a language to describe REST Web services.

..

It is I suppose possible to translate from WSDL 1.1 to WSDL 2.0 and then to WADL - not sure that will be very useful tho.

Best Regards

Tony