Требования к HTTP запросам

HTTP Headers

Каждый запрос к API EasyDonate должен сопровождаться передачей HTTP заголовка User-Agent. Если заголовок пустой или некорректный, система посчитает запрос подозрительным и заблокирует в целях безопасности.

Рекомендуется устанавливать небольшой User-Agent, чтобы быть уверенным, что запрос обработается корректно.

Обратите внимание, что запросы со слишком длинным заголовком User-Agent могут расцениваться как подозрительные и блокироваться на стороне EasyDonate.

Корректные User-Agent: EasyDonate, MyProjectName, MyProjectName/version Некорректный User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/89.0.4389.114 Safari/537.36

Примеры запросов с использованием User-Agent

С использованием file_get_contents()

try {
		echo file_get_contents(
				'https://easydonate.ru/api/v2/shop/{key}',
				false,
				stream_context_create([
						'http' => [
								'header' => 'User-Agent: EasyDonate'
						]
				])
		);
} catch (Exception $e) {
		exit($e->getMessage());
}

С использованием расширения cURL

$curl = curl_init('https://easydonate.ru/api/v2/shop/{key}');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
    'Accept: application/json',
    'Content-Type: application/json',
    'User-Agent: EasyDonate'
]);

try {
    $response = curl_exec($curl);
    curl_close($curl);
} catch (Exception $e) {
    exit($e->getMessage());
}

echo $response;

GuzzleHttp библиотека

$client = new GuzzleHttp\Client([
    'http_errors' => false
]);

try {
    $response = $client->get('https://easydonate.ru/api/v2/shop/{key}', [
        'headers' => [
            'Accept' => 'application/json',
            'Content-Type' => 'application/json',
            'User-Agent' => 'EasyDonate'
        ]
    ])->getBody()->getContents();
} catch (Exception $e) {
    exit($e->getMessage());
}

echo $response;

Лимит запросов

В целях безопасности и защиты от потенциальных DDoS атак на API EasyDonate действует ограничение на количество отправляемых HTTP запросов с одного IP адреса: максимум 3 RPS (запроса в секунду).