WTF эти API-интерфейсы?

  • 4 октября, 16:35
  • 1199
  • 0

Вы, вероятно, слышали об  API,  веб-сервисах,  конечных точках и других странных словах, таких как  200  и  401.  Что, черт возьми, это значит и в чем разница между ними?

Что такое API?

API или программный интерфейс приложения, это то, что позволяет различным приложениям взаимодействовать друг с другом. Web Service представляет собой тип API , который взаимодействует через Интернет.

Как правило, когда приложения взаимодействуют друг с другом, происходит обмен  запросами  и  ответами 

  • Запрос - просит что-то
  • Ответ  - ответ на запрос

Приложение A отправляет запрос в приложение B. Приложение B отправляет ответ обратно в приложение A.

Подобно тому, как просить что-то в реальной жизни, вы можете не получить ответ, который вы хотели бы или ожидаете. 

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

Есть определенные фразы, которые современные технические специалисты используют, когда говорят об API:

Запросы

  1. «Сделать / запустить вызов API»: сделать запрос.
  2. «Сделать запрос GET»: сделать запрос на получение данных.
  3. «Сделать POST-запрос»: сделать запрос на создание данных.
  4. «Сделать запрос PUT»: сделать запрос на обновление данных.
  5. «Конечная точка»: например, URL ( https://twitter.com/songthamtung ).
  6. «Hit  конечной точки»: выполнить запрос по указанному URL.

Ответ

  1. «200» : код ответа HTTP okey.
  2. «301» : код ответа HTTP для Redirect.
  3. «400»:  код ответа HTTP для неверного запроса.
  4. « 401 »: код ответа HTTP для неавторизованного пользователя.
  5. «403»:  код ответа HTTP для «Запрещено».
  6. «404» : код ответа HTTP для Not Found.
  7. «500» : код ответа HTTP для внутренней ошибки сервера.
  8. «504» : код ответа HTTP для тайм-аута.

Аутентификация

  1. «OAUTH»:  способ предоставления приложениями разрешения с использованием токенов.
  2. «Токен»: форма аутентификации, аналогичная имени пользователя / паролю.
  3. «Обновить токен»: токены могут и действительно истечь. Если вы получаете 401, рассмотрите возможность обновления вашего токена API.

Еще пара важных терминов

  1. «Открытый API»: доступен для публичного использования.
  2. «Закрытый API»: недоступен для публичного использования.
  3. «Ограничение API»: некоторые API имеют ограничение на количество запросов, которые вы можете сделать в течение определенного периода, например (1000 запросов в день).
  4. « CRUD»: создание, чтение, обновление и удаление.
  5. «Header» : объясняет тип отправляемых данных.
  6. «Body» : отправляемые данные.
  7. «GUID»:  глобальный уникальный идентификатор, который используется для отличительных записей, например (e20f5d52–5490–4523–87c5-af46dadfe7c1).
  8. «JSON» : тип формата данных, характеризуемый {«ключом»: «значением»}
  9. «XML» : тип формата данных, характеризуемый <tag> значением </ tag>
  10. «REST (ful) API» : тип API, использующий ограничения REpresentational State Transfer.
  11. «SOAP API» : тип API, который использует простой протокол доступа к объектам и основан на XML.
  12. «GraphQL» : язык запросов для API.

0 комментариев
Сортировка:
Добавить комментарий

IT Новости

Смотреть все