Правильно ли я понимаю что такое API?

Question

[grom111]

Всем привет. Читаю про API, но что-то совсем въехать не могу.
В моем понимании (из того что я прочитал) API это код в виде JSON'a или JS function's, который приходит как ответ от сервера сайта на который мы отправляем запрос и который помогает нам строить какие-то свои applications полагаясь на данные с API.

То есть допустим я делаю запрос, мне в ответ приходит JSON, я его могу пропарсить и работать с теми данными.

Правильно ли я понимаю?

Answer 1

[Stalker_RED]

Неправильно.

API (application programming interface) - набор готовых классов, процедур, функций, структур и констант, предоставляемых приложением (библиотекой, сервисом) или операционной системой для использования во внешних программных продуктах.

https://ru.wikipedia.org/wiki/API

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

Может быть при этом они вам вернули результат, иногда он даже бывает в формате JSON.

Анекдот

Едут по Австралии биолог, физик и математик.
И видят: на лугу пасется черная овца.
Биолог: Смотрите, в Австралии обитают черные овцы.
Физик: Нет, в Австралии обитает как минимум одна черная овца.
Математик: Нет, господа. В Австралии обитает как минимум одна
овца, и как минимум с одной стороны она черная.

Comments

[ThePrint]

Где не правильно? Это прикладной уровень, всё работает по запросам.
Он посылает запрос, ему приходит ответ. Он обрабатывает ответы, тем самым управляя сервером через запросы.

[Антон Спирин]

ThePrint,

Он обрабатывает ответы, тем самым управляя сервером через запросы

это, пожалуй, самая большая глупость, что приходилось читать сегодня.

[Tortway]

ThePrint, Потому что API это не код в виде JSON. API - это API, а JSON - это JSON. Читай ссылку.

[ThePrint]

Антон Спирин, То есть ты хочешь сказать что если я в строке https://toster.ru/q/493901напишу https://toster.ru/q/453901 изменив 1 цифру, я не заставлю сервер отобразить мне другой пост?

[Антон Спирин]

ThePrint, во-первых, перечитайте слова под которыми вы написали ответ "Да, верно."

В моем понимании (из того что я прочитал) API это код в виде JSON'a или JS function's, который приходит как ответ от сервера сайта на который мы отправляем запрос и который помогает нам строить какие-то свои applications полагаясь на данные с API.

Во-вторых перечитайте свою фразу, которую я процитировал и попробуйте сами понять, что написали.

В-третьих не надо пытаться фразой "То есть ты хочешь сказать" вложить в мой комментарий смысл, который я туда не вкладывал. То, что я хотел сказать, я сказал под цитатой.

[Stalker_RED]

ThePrint, а если я напишу

WIMCaptureImage(hWim, pszCaptureDir, dwCaptureFlags)

и оно вернет мне не JSON, не HTML, а образ в wim-формате, то это не API? Вы берете очень частный случай.

[Tortway]

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

[Decadal]

Ничего, ничего, когда-нибудь до SOAP дойдут

Answer 2

[SagePtr]

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

В вашем примере вы заталкиваете страусу в попу HTTP-запрос, он его обрабатывает и через эту же попу возвращает вам результат в формате JSON. Но это только особенности работы конкретного API, в Windows API к примеру вы вызываете функции, которые возвращают вам результат (либо в регистр процессора его записывают, либо кладут в память по адресу, который вы задаёте одним из параметров функции). Ещё некоторые API возвращают ответ в формате XML, а некоторые и вовсе позволяют выбрать желаемый формат ответа.

Comments

[grom111]

Ахха, спасибо)

Answer 3

[Антон Спирин]

Сама аббревиатура API расшифровывается как программный интерфейс приложения, интерфейс на уровне чего угодно от класса до целого сервиса. Вы наверное имели ввиду API веб-сервиса или REST API.
Как бы объяснить попонятней, API веб-сервиса это публичный или закрытый интерфейс взаимодействия, реализуемый посредством HTTP-запросов (GET, POST, PUT, PATCH, DELETE) и ответов. Ответы обычно в формате JSON.
Обработчики конкретных запросов на сервере называют эндпоинтами. Пример типичных эндпоинтов:
GET 'api/v1/products' - вернет массив товаров.
GET 'api/v1/product/:id' - вернет один товар по id
POST 'api/v1/product' - добавляем товар, отправив в теле запроса JSON с данными и получаем в ответ его же, но уже с присвоенным базой данных id или просто id.
PATCH 'api/v1/product/:id' - обновляем товар отправляя измененные поля в виде JSON и получаем измененный товар или success.
DELETE 'api/v1/product/:id' - удаляем товар, получая в ответе success.

Основные пользователи REST API это мобильные и веб приложения. Часто многие сервера и сайты используют API сторонних сервисов.

Answer 4

[ThePrint]

Да, верно.

Answer 5

[Данил Разумков]

Это набор функций где то на другом сайте, приложении. Например vk.api. Их использование предусмотрено создателями.

Comments

[ThePrint]

И что? Он управляет функционалом своего приложения. Были бы у вас тогда смайлики в ICQ если бы это не поддерживали клиенты?

[Данил Разумков]

Ну а я про что? "Это набор функций где то на другом сайте, приложении." Можно дополнить, возвращающих какие то данные, чаще всего в формате JSON, для дальнейшей работы с ними.

[Stalker_RED]

Данил Разумков, спорим, на этой планете сайтов гораздо меньше, чем компов с виндой? И запросы к win-api происходят намнооого чаще, чем к любым серверам. И возвращают они не JSON, а множество всякой всячины.

Так что утверждение "чаще всего в формате JSON" - смело вычеркиваем.

А может быть смартфонов на андроиде еще больше, чем компов с виндой, но все равно утверждение про JSON - ложное. Автор вопроса неявно подменил API вообще на API какого-то веб-сервера, а ThePrint повелся.