---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.3
alternate:
  - https://yandex.com/dev/partner-objects/doc/en/concepts/access.md
  - https://yandex.com/dev/partner-objects/doc/ru/concepts/access.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/partner-objects/doc/ru/llms.txt


# Доступ к API

Хост для всех запросов к API:

<!-- httpget -->
```http
https://jsonapi.partner2.yandex.com/vX/
```

где `X` — [номер версии](https://yandex.com/dev/partner-objects/doc/ru/concepts/versions.md) API.

<!-- <note>
  <p>При подключении рекомендуется указывать только мажорную версию (т.е. не указывать третье число версии).</p>
</note> -->

Чтобы работать с API, необходимо использовать API-ключ.

Ключ можно передать, используя один из вариантов:

- передать ключ в HTTP-заголовке `Authorization` и указать тип `token` перед значением.

    ```
    Authorization: token ac3b42lp-89ls-...
    ```
    
- передать в качестве query-параметра.

    ```
    curl -g -i -H "Accept: application/vnd.api+json" GET 'https://jsonapi.partner2.yandex.com/vX/resources?page\[size\]=2&apikey=e78...'
    ```
    
<!--<ol>
        <li>Сформировать ключ в&#160;<xref href="https://developer.tech.yandex.ru" scope="external">Кабинете разработчика</xref>.</li>
        <li>Пройти процедуру <xref href="../../../developer-help/doc/index.xml#index/new-key">активации ключа</xref>.</li>
        <li>Использовать ключ в&#160;каждом запросе к&#160;API. Ключ можно передать, используя один из вариантов:<p><ul>
              <li>передать ключ в HTTP-заголовке <parmname>Authorization</parmname> и указать тип <codeph>token</codeph> перед значением.<codeblock code-lang="no-highlight">Authorization: token ac3b42lp-89ls-...</codeblock></li>
              <li>передать в&#160;качестве
                query-параметра.<codeblock code-lang="no-highlight">curl -g -i -H &quot;Accept: application/vnd.api+json&quot; GET &apos;https://jsonapi.partner2.yandex.com/vX/resources?page\[size\]=2&amp;apikey=e78cf1a0ebbb19...&apos;</codeblock></li>
            </ul></p></li>
            </ol>-->