В каком формате сделать ответ API?

Question

[Оптимус Пьян]

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

$data = intval(file_get_contents('http://www.site.com/?key=123&query=abcd'));

Или отдавать в XML, но тогда получающему надо будет распарсить xml ради одной цифры...

Answer 1

[VZVZ]

А если ошибка какая? Лучше JSON и XML (именно ОБЕ версии - и JSON приоритетнее).
Но можно оставить и такой вариант - как еще одна версия.
А в идеале, еще и четвертый вариант добавить - возвращать сразу HTML, это не для приложений, а для аякса в браузере, - чтобы не нагружать клиент (браузер) лишним парсингом JSON/XML/цифры.
А может еще и пятый, шестой, седьмой)) смотря что за сервис

Answer 2

[Тимур Сергеевич]

$data = intval(file_get_contents('http://www.site.com/?key=123&query=abcd&format=xml'));
$data = intval(file_get_contents('http://www.site.com/?key=123&query=abcd&format=json'));
$data = intval(file_get_contents('http://www.site.com/?key=123&query=abcd&format=html'));
и т д

Comments

[VZVZ]

Еще бы REST URL желательно. Типа как у VK: api.vk.com/method/users.get.json?user_ids=1

[Оптимус Пьян]

VZVZ: Что за REST URL это типа заранее заданный адрес на который API возвращает результат своей работы?

[Тимур Сергеевич]

Дмитрий: Он наверно имел виду типа www.site.com/123/abcd/xml

[Оптимус Пьян]

Тимур Сергеевич: А чем это от вашего варианта отличается не понял...

[VZVZ]

Дмитрий: красивый URL.
Сравните:
site.com/ajax.php?method=get_post&nick=Ivanov&post_id=5
А вот REST:
site.com/Ivanov/5

[Оптимус Пьян]

VZVZ: Ну он только URL что ли красивый сделал? Ну можно через роутинг сделать, но это же в невидимой части сайта )) У ВК например api.vk.com/oauth/access_token?client_id=".$APP_ID."&client_secret=".$SECRET_CODE."&code=".$CODE." и никто не парится

[Тимур Сергеевич]

VZVZ: Так делайте как вам удобно) Только внутренняя логика не должна меняться от этого.

[VZVZ]

Дмитрий: прописывается в невидимой - а функционал в видимой. В случае с токеном, все норм, REST - это для CRUD придумано.