---
metadata:
  - name: generator
    content: Diplodoc Platform v5.55.0
alternate:
  - https://yandex.com/dev/market/partner-api/doc/en/concepts/api-key.md
  - https://yandex.com/dev/market/partner-api/doc/ru/concepts/api-key.md
  - https://yandex.com/dev/market/partner-api/doc/zh/concepts/api-key.md
  - href: zh/concepts/api-key.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/market/partner-api/doc/zh/llms.txt

# 创建和使用 API-Key-令牌

与之合作   都市人   通过API:

1. 创建一个可以访问某些方法组的令牌。 这样，员工将能够只调用他们工作所需的方法。   
2. 在请求标头中插入令牌   致都市人  .

只有内阁所有者和内阁经理才能创建和管理令牌.   

内阁令牌的最大数量 — 30.

令牌无限期有效 — 它保持活动状态，直到您将其删除。

## 创建令牌 {#new-token}

1. 在办公室   都市人   点击您的帐户图标→ **设置** 在左边的菜单中，选择   **空气污染指数综合**  .

1. 在街区里 **授权令牌** 点击按钮 **创建新令牌**.

    


1. 在打开的窗口中:

    1. 指定令牌的唯一名称。

    1. 选择要授予的访问权限。

    1. 点击按钮 **要创建**.

    


## 编辑令牌 {#edit-token}


{% note warning "Перед редактированием" %}


确保您的集成将继续使用修改后的令牌。


{% endnote %}


您可以更改访问权限以及令牌的名称。 要做到这一点:

1. 在办公室   都市人   点击您的帐户图标→ **设置** 在左边的菜单中，选择   **空气污染指数综合**  .

1. 在街区里 **授权令牌** 找到你需要的，点击旁边的三个点，然后选择 **编辑**.

1. 更改所需信息。

1. 点击 **储蓄**.

信息将在10分钟内更新。

## 删除令牌 {#delete-token}


{% note warning "Перед удалением" %}


请确保您的集成将在没有此令牌的情况下继续工作。


{% endnote %}


1. 在办公室   都市人   点击您的帐户图标→ **设置** 在左边的菜单中，选择   **空气污染指数综合**  .

1. 在街区里 **授权令牌** 找到你需要的，点击旁边的三个点，然后选择 **移走**.

1. 确认删除。

## 转移令牌 {#use}

将接收到的令牌插入到标头中 `Api-Key` 根据以下方案:

```no-highlight translate=no
Api-Key: <token>
```

因此，标题将如下所示:

```no-highlight translate=no
Api-Key: ACMA:I4c4CxCSYaI41RSC2uYWP2qj3Rhhm4knMiBEga5K:151c0664
```

如果请求没有带有有效令牌的标头,   都市人   返回错误。 `401 Unauthorized`.

## 它可能是有用的 {#read-more}



* [UrbanAds API返回的错误说明](https://yandex.com/dev/market/partner-api/doc/zh/concepts/error-codes.md)