Вы, вероятно, слышали об  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.