Каков предпочтительный метод для веб-сервиса WSDL для REST?

Вы можете попробовать Swagger (теперь OpenAPI), который позволяет описывать службы REST с использованием открытого стандарта JSON.

REST действительно использует только глаголы HTTP (GET, PUT, POST, DELETE) для ресурса. Все операции над ресурсом должны быть представлены таким образом. POST используется как универсальное средство, когда вы не можете выразить свою бизнес-логику так, чтобы она соответствовала остальным трем. Вот почему на самом деле нет WSDL для службы REST, поскольку у вас всегда есть только 4 метода на ресурсе. Обратите внимание, что библиотека REST Zend Framework на самом деле не является RESTful, а скорее представляет собой простой старый сервис XML (POX).

Хотя Сэм прав в том, что веб-приложениям RESTful не нужен прямой аналог WSDL, существует словарь XML, полезный для описания веб-приложений RESTful: WADL или Язык описания веб-приложений. В моей компании мы в основном используем WADL для определения спецификации для данного сервиса, который мы хотим создать, — обычно мы не используем его программно. При этом домашняя страница WADL содержит некоторые инструменты Java для генерации кода, а Restlet, среда Java REST, включает расширение WADL для динамического подключения приложений на основе WADL и динамического создания WADL на основе подключенного приложения. Я поклонник WADL и рекомендую вам ознакомиться с ним.

На самом деле для этого можно использовать WSDL, но это должна быть версия 2.0 - см. заголовок "Описание веб-служб REST с помощью WSDL 2.0".

Вы можете предоставить XSD, если вы используете XML в своей службе REST.

Или просто примеров XML в любом случае должно быть достаточно, чтобы разобраться с простыми структурами данных.