Tengo una gran cantidad de servicios web SOAP, pero estoy construyendo un servicio web REST para un proyecto específico, y me preguntaba qué personas usaban para un 'WSDL' para servicios REST o incluso si era necesario.¿Cuál es el método preferido para un 'WSDL' para el servicio web REST?
Puede probar Swagger (ahora OpenAPI) que permite describir los servicios REST utilizando un estándar abierto JSON.
Puede suministrar un XSD si está utilizando XML en su servicio REST.
O simplemente ejemplos de XML, deberían ser suficientes para resolver las estructuras de datos simples de todos modos.
REST realmente solo usa los verbos HTTP (GET, PUT, POST, DELETE) en un recurso. Se supone que todas las operaciones en un recurso se representan de esa manera. POST se usa como una forma de atrapar todo cuando no puede expresar su lógica de negocios de una manera que se ajuste a las otras tres. Es por eso que realmente no hay un WSDL para un servicio REST ya que solo tiene 4 métodos en el recurso. Tenga en cuenta que la biblioteca REST de Zend Framework no es realmente RESTful y es más un simple servicio XML anterior (POX).
Si bien Sam está de acuerdo en que las aplicaciones web RESTful no necesitan un análogo directo a WSDL, existe un vocabulario XML que es útil para describir aplicaciones web RESTful: WADL o Web Application Description Language. En mi empresa, utilizamos principalmente WADL para definir una especificación para un servicio determinado que queremos construir; generalmente no la usamos programáticamente. Dicho esto, the WADL home page incluye algunas herramientas Java para la generación de código, y Restlet, el marco REST de Java, incluye una extensión WADL para el cableado dinámico de aplicaciones basadas en WADL y la generación dinámica de WADL basada en una aplicación cableada. Soy fanático de WADL, y recomiendo que lo revises.
En realidad, es posible usar WSDL para eso pero debería ser v 2.0 - ver el artículo "Describe REST Web services with WSDL 2.0".
No creo que la pregunta sea sobre contenido XML, sino más bien sobre la definición del contrato API y la forma de los datos intercambiados, independientemente de su formato. –