Доступ к API

Для использования API необходимо получить API-ключ, привязанный к доменному имени, с которого приложение будет обращаться к API Яндекс.Услуг.

Получение ключа

Чтобы получить ключ, необходимо отправить письмо с запросом на адрес info@uslugi.yandex.ru. В письме следует указать доменное имя, на котором планируется использовать API. Яндекс.Услуги генерируют API-ключ для указанного доменного имени и высылают в ответном письме.

Каждый ключ регистрируется для одного доменного имени (например, для http://mydomain.com). Ключ, зарегистрированный на домен, будет действителен для:

• всех поддоменов этого домена;
• всех URL внутри домена и его поддоменов
• всех портов.

Например, если ключ зарегистрирован для домена http://www.mydomain.com, он будет действителен для URL:

• http://www.mydomain.com/;
• http://www.mydomain.com/mysite/.

Но не будет действителен для URL:

• http://mydomain.com/;
• http://host1.mydomain.com/;
• http://host2.mydomain.com/mysite.

Ключ, зарегистрированный для домена http://mydomain.com, будет действителен для всех URL, перечисленных выше.

Использование ключа

Каждый запрос к API Яндекс.Услуг должен содержать:

• API-ключ, который может быть передан либо в HTTP-заголовке Authorization, либо в качестве значения параметра запроса key. Параметр key имеет более высокий приоритет.
• HTTP-заголовок Referer c корректным URL, для которого действителен указанный API-ключ;

В случае превышения лимита на количество запросов API-ключ может быть временно заблокирован (на 5 минут). В случае регулярных нарушений, ключ может быть заблокирован окончательно.