.. _`тестовой площадке`: https://extern-api.testkontur.ru/
.. _`сайте`: https://kontur.ru/extern/api
.. _`“Выпустить ключ”`: https://integrations.kontur.ru/documentation#issue
.. _`самостоятельную интеграцию`: https://integrations.kontur.ru/documentation#self-integrations

Получение api-key
=================

* api-key необходим для идентификации приложения при работе с API Контур.Экстерна;  
* api-key представляет собой GUID;
* api-key нужно передавать только для получения Access Token.

К api-key всегда привязано уникальное сервисное имя приложения **client_id**. Оно назначается один раз в момент подключения к API. 

Перед началом интеграции можно получить api-key для работы на `тестовой площадке`_. Она позволяет изучить функциональность и возможности API.

Если примите решение начинать интеграцию, то необходимо заключить договор с Контуром и получить api-key для работы на боевой площадке

Как получить тестовый ключ
~~~~~~~~~~~~~~~~~~~~~~~~~~

1. Оставьте заявку на `сайте`_, чтобы получить **client_id** и **api-key** для работы на `тестовой площадке`_. Менеджер свяжется с вами и отправит письмо с данными учетной записи:
    
    * логин и пароль от тестовой учетной записи Контур.Экстерн;
    * ИНН-КПП и название организации;
    * отпечаток и архив сертификата;
    * **client_id** и ссылку на выпуск тестового **api-key**.

2. Перейдите по ссылке из письма и выпустите **api-key** по кнопке `“Выпустить ключ”`_.

Как получить боевой ключ
~~~~~~~~~~~~~~~~~~~~~~~~

1. Оставьте заявку на `сайте`_, чтобы получить **client_id** и **api-key** для работы на боевой площадке. Либо обратитесь к менеджеру, у которого получали тестовый api-key. Менеджер свяжется с вами и отправит письмо с данными вашей учетной записи.
2. Выпустите **api-key** по кнопке `“Выпустить ключ”`_.
3. Создайте `самостоятельную интеграцию`_.

При возникновении вопросов и ошибок
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Если во время интеграции возникли вопросы или ошибки, напишите на почту extern-api.help@skbkontur.ru.