Что такое конечная точка?

172

Я читал об OAuth, и он продолжает говорить о конечных точках. Что именно является конечной точкой?

Klanestro
источник
2
Я продолжаю спотыкаться о старых сообщениях, подобных этим, и не могу понять, почему этот вид поста всегда голосовал в прошлом, но он определенно был бы оскорблен и опущен, если бы это была текущая публикация.
tnkh
6
Может быть, за него проголосовали, потому что этот вопрос есть и у других людей. Разве это не главное?
Нора Макдугалл-Коллинз

Ответы:

74

Все ответы, опубликованные до сих пор, являются правильными, конечная точка - это просто один конец канала связи. В случае OAuth есть три конечные точки, с которыми вам нужно иметь дело:

  1. URI временного мандатного запроса (URL-адрес маркера запроса в спецификации сообщества OAuth 1.0a). Это URI, на который вы отправляете запрос, чтобы получить несанкционированный токен запроса от сервера / поставщика услуг.
  2. URI авторизации владельца ресурса (URL-адрес авторизации пользователя в спецификации сообщества OAuth 1.0a). Это URI, на который вы указываете пользователю авторизовать токен запроса, полученный из временного URI запроса учетных данных.
  3. URI запроса токена (называется URL-адресом токена доступа в спецификации сообщества OAuth 1.0a). Это URI, на который вы отправляете запрос для обмена авторизованным токеном запроса на токен доступа, который затем можно использовать для получения доступа к защищенному ресурсу.

Надеюсь, что это поможет прояснить ситуацию. Получайте удовольствие, узнавая об OAuth! Если у вас возникнут какие-либо трудности с реализацией клиента OAuth, отправьте больше вопросов.

Пол Осман
источник
5
Почему бы просто не назвать его (то есть так называемой «конечной точкой») «базовым URI»? Есть ли принципиальная разница между «конечной точкой» и «базовым URI»? Спасибо.
Удержано
@Xlsx Это зависит от реализации. Примером запроса может быть GET "/ users? Name = admin" или "/ users / admin". Вы можете сделать одно или другое, или оба, или ни то, ни другое.
Бурак
2
Бесполезно, поскольку OP запрашивает «общие конечные точки», а не OAuth. Я сейчас в замешательстве.
рассвет
312

Давай, ребята :) Мы могли бы сделать это проще, на примерах:

/this-is-an-endpoint
/another/endpoint
/some/other/endpoint
/login
/accounts
/cart/items

и когда положить под домен, это будет выглядеть так:

https://example.com/this-is-an-endpoint
https://example.com/another/endpoint
https://example.com/some/other/endpoint
https://example.com/login
https://example.com/accounts
https://example.com/cart/items

Может быть http или https, мы используем https в примере.

Также конечная точка может отличаться для разных методов HTTP, например:

GET /item/{id}
PUT /item/{id}

будет два различных конечных точек - один для г etrieving (как в «с Р уд» аббревиатура), а другой для у pdating (как в «CR U D»)

И это все, действительно так просто!

Tomeg
источник
25
Признан за упоминание, что разные методы HTTP определяют отдельные конечные точки.
Боян Кушлев
4
Мэтью 20:16 KJV - Таким образом, последний будет первым (..) :)
sobi3ch
2
Это очень плохо, Stack Exchange не показывает этот ответ в качестве первого или второго ответа. Для меня это был путь вниз по списку и, безусловно, лучший, поскольку я не знал, считали ли конечной точкой целый набор действий и контроллеров, или одно действие в одном контроллере определяло конечную точку. Этот ответ сказал мне, что это был последний.
Торкил Вурге
Так жаль, что ОП не выбрал этот ответ, который является лучшим ответом.
1
@ Как правило, конечная точка - это то, что должно вызываться запросом, то, что вы предоставляете в качестве интерфейса для ваших потребителей API - то, что вы говорите им использовать. Итак, в этом примере ваша реализация обрабатывает две конечные точки (потому что вы предоставили потребителю / пользователю API два способа вызова чего-либо). Но я только что написал, что это «в целом», и если есть кто-то, кто настаивает на том, чтобы назвать конечную точку немного иначе (например, в вашем примере кто-то настаивал бы на том, что это одна конечная точка), то вы говорите: «Хорошо, что угодно, это просто слова! Я достаточно счастлив, что мы просто понимаем друг друга "
Томег
43

Это один конец коммуникационного канала, поэтому часто он представляется в виде URL-адреса сервера или службы.

Дэвид М
источник
35

Конечная точка - это шаблон URL, используемый для связи с API.

SirLemuel
источник
12

Конечная точка в жаргоне аутентификации OpenID - это URL, на который вы отправляете (POST) запрос аутентификации.

Выдержки из API аутентификации Google

Чтобы получить конечную точку Google OpenID, выполните обнаружение, отправив HTTP-запрос GET или HEAD по адресу https://www.google.com/accounts/o8/id . При использовании GET мы рекомендуем установить заголовок Accept на «application / xrds + xml». Google возвращает документ XRDS, содержащий URL-адрес конечной точки поставщика OpenID. Адрес конечной точки помечается как:

<Service priority="0">
<Type>http://specs.openid.net/auth/2.0/server</Type> 
<URI>{Google's login endpoint URI}</URI> 
</Service>

После того, как вы приобрели конечную точку Google, вы можете отправлять ей запросы на аутентификацию, указав соответствующие параметры (доступные на связанной странице). Вы подключаетесь к конечной точке, отправляя запрос на URL-адрес или отправляя запрос HTTP POST.

Amarghosh
источник
7

Конечная точка - это «точка подключения» службы, инструмента или приложения, доступ к которым осуществляется по сети. В мире программного обеспечения любое приложение, которое работает и «прослушивает» соединения, использует конечную точку в качестве «входной двери». Когда вы хотите подключиться к приложению / услуге / инструменту для обмена данными, вы подключаетесь к его конечной точке

Джастин франкс
источник
4

Термин Конечная точка изначально использовался для сервисов WCF. Позже, хотя это слово используется как синоним ресурсов API, REST рекомендует называть эти URI (URI, которые понимают глаголы HTTP и следуют архитектуре REST) ​​«Ресурсом».

В двух словах, ресурс или конечная точка - это своего рода точка входа в удаленно размещенное приложение, которое позволяет пользователям взаимодействовать с ним по протоколу HTTP.

Кришна Кант
источник
4

Отрицательное голосование (я) не имеет никакого отношения ко мне, но источник (: Даже нет причин для этого указано.


Каждая конечная точка - это местоположение, из которого API могут получить доступ к ресурсам, необходимым для выполнения их функций. То есть место, куда API отправляют запросы и где живет ресурс, называется конечной точкой.

Из хорошего источника .

ОСШ
источник
2

Конечной точкой термина является URL, который ориентирован на создание запроса. Взгляните на следующие примеры с разных точек зрения:

/api/groups/6/workings/1
/api/v2/groups/5/workings/2
/api/workings/3

Они могут четко обращаться к одному и тому же источнику в данном API.

Исмаэль
источник
1

Краткий ответ: «конечная точка - это абстракция, которая моделирует конец канала сообщений, через который система может отправлять или получать сообщения» ( Ibsen, 2010 ).


Конечная точка против URI (значения)

Конечная точка не совпадает с URI. Одна из причин заключается в том, что URI может двигаться к различным конечным точкам, таким как конечная точка для GET, другая для POST и так далее. Пример:

@GET /api/agents/{agent_id} //Returns data from the agent identified by *agent_id*
@PUT /api/agents/{agent_id} //Update data of the agent identified by *agent_id*

Конечная точка против ресурса (значения)

Конечная точка не совпадает с ресурсом. Одна из причин заключается в том, что разные конечные точки могут работать с одним и тем же ресурсом. Пример:

@GET /api/agents/{agent_id} @Produces("application/xml") //Returns data in XML format
@GET /api/agents/{agent_id} @Produces("application/json") //Returns data in JSON format
Клебер Хорхе Амарал
источник
0

Проще говоря, конечная точка - это один конец канала связи. Когда API взаимодействует с другой системой, точки взаимодействия этого взаимодействия считаются конечными точками. Для API конечная точка может включать URL-адрес сервера или службы. Каждая конечная точка - это местоположение, из которого API могут получить доступ к ресурсам, необходимым для выполнения их функций.

API работают с использованием «запросов» и «ответов». Когда API запрашивает информацию у веб-приложения или веб-сервера, он получает ответ. Место, куда API отправляют запросы и где находится ресурс, называется конечной точкой.

Читать далее...

Saikat
источник