Как открыть веб-службы RESTful?

Когда я хочу найти "большой" веб-сервис (WS - */WSDL) требуемой функциональности, я могу просто google для ".... filetype: wsdl", потому что Google индексирует также определения WSDL. Или я могу просто использовать некоторые реестры, которые уже сканировали Web для определения WSDL для меня, например. SeekDa.com или ServiceFinder.

Когда я хочу найти веб-службу RESTful (RESTful Web API), я могу рассчитывать только на сообщество, потому что невозможно различать URI веб-службы RESTful и другие веб-ресурсы (например, URL-адреса веб-сайтов), и, следовательно, любые сфокусированный искатель не может сказать на 100% уверен: это URI веб-сервиса RESTful. Итак, я пришел, например. на ProgrammableWeb.com, и я надеюсь, что кто-то уже использовал/нашел сервис, который я ищу, и зарегистрировал его там.

Недавно я искал веб-сервис для расширения аббревиатуры. Я не мог найти его на порталах, таких как ProgrammableWeb, потому что никто его не поставил. Наконец, я был вынужден просматривать несколько аббревиатурных словарей сайтов, копать и сверлить там, и я наконец нашел API-интерфейс Abbreviations.com в форме RESTful. Это заняло у меня много времени!

Есть ли другой способ открыть веб-службы RESTful в Интернете?

Ответ 1

Идея REST заключается в том, что услуги такие же потребляемые, как и веб-страницы, им не нужны реестры. [Должен признать, что я не полностью "получаю" последствия этого мира RESTful, нет WSDL, никакой реестр не похож на велосипед без стабилизаторов.]

В старой сети, пред-Google, как мы находим страницы? Эффективно из уст в уста и несколько ключевых отправных точек. Службы REST, насколько я могу видеть, в значительной степени находятся на этапе до Google.

Я не согласен с тем, что "невозможно провести различие между URI веб-службы RESTful и другими веб-ресурсами" - если мы будем следовать ссылке, мы получим определенные типы приложений /xml и application/json для контента, которые будут довольно сильными индикаторы не так ли?

Ответ 2

Существует соглашение (рекомендуется в Руководстве по дизайну REST API), в котором вы показываете конечную точку /api в корневой части вашей службы. Это возвращает ответ XML или JSON, содержащий "дочерние" ресурсы, поддерживаемые вашей службой, например./API/продукты

Ответ 3

Там есть WSDL-подобный файл для веб-сервисов REST: он называется WADL.

Ответ 4

SoapUI теперь может открыть службы REST. Он работает как прокси-сервер, записывая все запросы/ответы, которые проходят. Имея запросы и ответы SoapUI воссоздает описания/определения сервисов. Теперь определения могут храниться в форматах WADL и WSDL (как WSDL и XML-Schema в мире XML). Он также может храниться в формате Swagger. Я предпочитаю Swagger. Swagger можно хранить в SwaggerHub прямо из SoapUI, что похоже на GitHub для исходного кода. SwaggerHub - одна из многих систем управления API.