SOAP - это API?

Question

У меня проблемы с пониманием, если SOAP считается API.Многие веб-сайты сравнивают SOAP и REST, однако, хотя REST всегда указывается как веб-API, SOAP всегда указывается как веб-служба.

Кроме того, я не уверен, что API и Web-Api - это одно и то же, за исключением того, что один находится в одной системе и один находится в сети.

Answer 1

REST описывает философию в разработке API или архитектурный стиль, если вы хотите: URI HTTP (s) идентифицируются с ресурсами, методы HTTP (S) идентифицируются с действиями;полезная нагрузка не обязательно определяется, но в последнее время обычно JSON.Например:

GET    http://www.example.com/myService/user              list users
GET    http://www.example.com/myService/user/1            get data on user with ID 1
PUT    http://www.example.com/myService/user              create a new user
DELETE http://www.example.com/myService/user/1            delete the user with ID 1

SOAP также описывает стиль архитектуры веб-службы (точнее, веб-службы - см. Ниже), но с гораздо более строгими требованиями: и запросы, и ответы имеют строго определенный диалект XML.Между тем, URI идентифицируют конкретные сервисы и не являются семантическими.Например, вот как выглядит SOAP-запрос (отправленный, например, http://www.example.com/myService):

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:x="http://www.example.org">
  <soap:Header>
  </soap:Header>
  <soap:Body>
    <x:GetUser>
      <x:UserId>1</m:UserId>
    </x:GetUser>
  </soap:Body>
</soap:Envelope>

Термин «API» немного двусмысленен: в основном это означает (абстрактное) определение способов, которыеможет быть вызвана библиотека или служба (1), но иногда она также используется для реализации этого определения (2), а также для документирования этого (абстрактного) определения (3).

1. Служба wuglet предоставляет функцию create с одним параметром - именем создаваемого wuglet.Возвращает идентификатор созданного вуглета.

2. В API имеется ошибка, пользователи сообщают, что не могут создавать новые вуглеты.

3. Как приготовить вуглет?Найдите это в API.

«Веб-сервис» - это еще один двусмысленный термин: это может быть любая служба, доступная через World Wide Web (т.е. использующая HTTP (S) протоколы);или это может быть, в частности, веб-служба W3C, представляющая собой особый дизайн веб-службы (универсальный), который включает UDDI, WSDL (еще два ETLA, о которых вам не нужно беспокоиться) и - SOAP.Веб-сервисы W3C в основном используются только в сложных корпоративных системах, таких как банковское дело;большинству людей не нужно знать о них подробно.

Web API - это просто API, который доступен через World Wide Web или, точнее, через HTTP (S) протоколы.API веб-службы ... см. Предыдущий абзац: то же, что и веб-API, или API определенной веб-службы в стиле W3C.