Я правильно понимаю принцип restfull api?

Question

[123qwe]

What is up, programmach.

Я создаю ряд методов(библиотеку), которые возвращают ту или иную информацию, например, о картинках.Если я создал галерею.
Я пишу адрес своего сайта, и если мне нужно получить инфу в формате json по своим картинкам, я пишу в адресной строке:
www.mysite.edu/gallery/new_pictures/getPictureInfo(5)

Подразумевая, что у меня есть в библиотеке готовый метод getPictureInfo, который возвращает инфу о картинке в формате json.В качестве параметра(ключа) я передал id картинки.

Answer 1

[Станислав Макаров]

Я создаю ряд методов(библиотеку)

Это RPC-стиль. См. RESTful API и MVC — что это?

Answer 2

[Александр]

Не совсем так.
REST архитектура веб-сервисов работает чуток иначе.
У протокола http существует несколько методов с помощью которых можно взаимодействовать с веб-сервером.
Каждый из методов необходим для разного действия над объектов в веб-сервисе. Например, GET server.ru/picture/1234556
Данный запрос получает картинку с идентификатором 1234556.
Если использовать метод DELETE - то удалить картинку.
POST - для добавления, например POST server.ru/picture в теле передаете содержимое картинки.
И т.д.
В apache для REST используется правила модуля mod_rewrite.
Например - такой запрос server.ru/picture/1234556 - настраивается на некоторую страницу - server.ru/getpicture.php?id=1234556.
И т.д.
Правила формирования URL в REST обычно представляет собой объект.
То есть server.ru/picture - работает с объектом Картинка.
server.ru/catalog с каталогом и т.д

Comments

[123qwe]

т.е rest api, и api для сайта(кастомный) - это разные вещи?Если мне по какой-то причине нужно создать свой, то то, что я написал - не правильно?Что именно мне нужно подкорректировать, что бы сделать свой, хотя бы простой api для сайта, что бы я мог инфу по картинкам в json'е получать?

[Александр]

REST API это всего лишь архитектура для веб-сервисов. В вашем примере все будет работать. Но это будет недоREST.
Это свод правил и рекомендаций для красиво оформленного веб-API. А так вы пишите любой обработчик запросов на сервере - в клиенте его зовете. Работать же будет :) Вопрос в другом, что это будет отличаться от стандарта архитектуры REST.

[123qwe]

Александр: мне задали вопрос на собеседовании, где было сказано, что бы создать свой api для сайта.Я просто пытаюсь понять, как это сделать.

[Александр]

123qwe: API для сайта - это всего лишь набор веб-сервисов возвращающих какие-либо данных с сайта. Может быть сделано на архитектуре REST(возвращает данные в любом формате, как сделает программист, обычно для REST это JSON, но может быть и XML или вообще в том формате, какой зададите) так и в виде SOAP сервисов (громоздкая штука, формат передачи XML), так и в любом произвольном формате - дергаете URL - в ответе текст, html, шифрованные данные, все что хотите.

Answer 3

[_ _]

REST это всего лишь соглашение. Точно так же, как соглашение об именовании переменных или соглашение о сигнатуре callback-функций в nodejs.
REST может сделать вашу жизнь легче, а также позволит вам использовать клиентские наработки, ориентированные на работу с REST-style API.
Сам по себе API подразумевает всего лишь возврат данных в машиночитаемом формате (ну и некий документированный набор входных данных, конечно), потому что API это Application Programming Interface, т.е. средство, позволяющее взаимодействовать с вашей разработкой сторонним приложениям.
Например, GET mysite.ru/news/article.html - вероятно не метод API, потому что скорей всего вернет уже оформленный html
GET mysite.ru/news/article.json - вероятно метод API, потому что скорей всего вернет данные статьи в JSON
.html и .json тут для наглядности, можно и через хэдер сказать серверу, какой тип контента тебе нужен.