Правильно ли отправлять версии PHP и Apache в строке агента пользователя для API? - PullRequest
Новая
       38

Правильно ли отправлять версии PHP и Apache в строке агента пользователя для API?

1 голос
/ 29 марта 2012

Я построил структуру API, которая включает в себя множество параметров, связанных со связью, включая проверку входных данных и шифрование.

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

Этот класс-оболочка делает запросы, используя cURL.

Моя система также включает в себя регистратор, который отслеживает вызовы API для будущих ссылок и расследований (если возникают проблемы, а также оценки производительности), включая отслеживание строки агента пользователя для всех этих запросов.

У меня вопрос: насколько хорошо или плохо, если я включу номера версий Apache и PHP в эту строку вместе с версией класса-обертки API, например: 

myApi/1.0 (Apache 2.2.17;PHP 5.4.0)

Меня беспокоит проблема, если номер версии PHP передается через Интернет таким образом, даже если он находится между серверами, а не между клиентским компьютером и сервером?

1 Ответ

4 голосов
/ 29 марта 2012

Я думаю, вы, возможно, пересекаете различие между API и клиентом.Перефразируя ваш вопрос, похоже, что вы создали:

  1. API с различными службами / ресурсами

  2. клиентский класс ("обертка "), которую сторонний разработчик может использовать в своем собственном приложении для связи с вашим API

Если это так, то информация о сервере, которую вы хотите передать, является системойтребования к приложению, которое будет использовать ваш клиентский класс.Это не имеет отношения к версии PHP, на которой работает ваш API, за исключением того, что вы разработали и API, и клиент на одной платформе.Например, если вы построили API в PHP и оболочку в Java, то было бы легче увидеть различие.

Минимальная версия PHP для класса клиент / оболочка - это важная информация для передачи третьему лицу.- разработчики вечеринок, чтобы они могли использовать класс по вашему усмотрению.В таком случае, тогда да, вы должны предоставить это где-нибудь (мое предложение будет в документации для класса-оболочки).

...