> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # 批量开启或关闭企业 AML 持续监控 API > 通过一次调用批量开启或关闭企业的持续 AML 监控，支持费用预估试运行、可轮询的任务以及每家企业的处理结果。Didit 提供支持。 为企业切换 AML 监控的提示词 将提示词复制到剪贴板 \

\`Goal: Enable or disable ongoing AML monitoring for one or many Didit Business (KYB) entities in a single call, with the same semantics as the Business Console. Preview the cost first with estimate_only, then run the change and read the per-business outcome.

Endpoint: POST https://verification.didit.me/v3/businesses/aml-monitoring/
Auth header: x-api-key: 
Content-Type: application/json

Request body:
\- is_enabled: boolean (required) - true to enable monitoring, false to disable it.
\- estimate_only: boolean (default false) - when true, returns the cost preview and performs NO writes: no screening, no billing, no job.
\- vendor_data_list: string[] - your own identifiers, matched exactly as sent.
\- didit_internal_id_list: string[] (UUIDs) - the didit_internal_id returned by the create, get and list endpoints.
Provide at least one list; the two are OR'd. At most 1000 identifiers per request across both lists - split larger selections into several calls.

Semantics:
\- One monitored screening per business: a company that verified several times is monitored and billed once. Disabling turns monitoring off across all of the business's screenings.
\- Businesses without any AML screening are screened first (billed as a regular AML screening) using their legal name (or display name) and country; a business with no name is reported as skipped_no_identity_data.
\- Sandbox applications never create screenings (skipped_sandbox).
\- Enabling is refused with 403 when the organization balance does not cover the estimate; the response carries the estimate.

curl (estimate first):
curl -X POST 'https://verification.didit.me/v3/businesses/aml-monitoring/' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"is_enabled": true, "estimate_only": true, "vendor_data_list": ["company-123", "company-456"]}'

Response 200 (estimate_only):
\{
"users_total": 2, "already_enabled": 0, "with_existing_aml": 1, "needing_screening": 1,
"skipped_no_identity_data": 0, "skipped_blocked": 0,
"estimated_screening_cost_usd": 0.2, "estimated_annual_monitoring_cost_usd": 0.14,
"balance_sufficient": true, "unmatched": []
}
(users_total counts the selected businesses; the estimate shape is shared with the users endpoint.)

curl (enable):
curl -X POST 'https://verification.didit.me/v3/businesses/aml-monitoring/' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"is_enabled": true, "vendor_data_list": ["company-123", "company-456"]}'

Response 200 (20 businesses or fewer - processed inline, already COMPLETED) or 202 (more than 20 - running in the background):
\{
"job_id": "", "status": "COMPLETED", "is_enabled": true, "target_type": "business",
"total": 2, "processed": 2,
"outcomes": {"enabled": 1, "screened_and_enabled": 1, "already_enabled": 0, "disabled": 0, "skipped_no_identity_data": 0, "skipped_blocked": 0, "skipped_sandbox": 0, "failed_provider": 0, "failed_insufficient_balance": 0},
"results": [
\{"didit_internal_id": "", "vendor_data": "company-123", "outcome": "enabled"},
\{"didit_internal_id": "", "vendor_data": "company-456", "outcome": "screened_and_enabled"}
],
"estimate": { ...same shape as above, without unmatched... },
"unmatched": [],
"error": null,                     // generic message when status is FAILED
"created_at": "", "completed_at": ""
}
On 202, poll GET /v3/aml-monitoring/jobs/{job_id}/ every couple of seconds until status is COMPLETED or FAILED; results fills in as businesses are processed.

Per-business outcome values: enabled, screened_and_enabled, already_enabled, disabled, skipped_no_identity_data, skipped_sandbox, failed_provider, failed_insufficient_balance (skipped_blocked is always 0 for businesses).

Failure modes:
\- 400 - is_enabled missing, no selector, or more than 1000 identifiers across both lists.
A selection that matches nothing is NOT an error: the job completes with total 0 and every identifier is listed under unmatched (same convention as the batch delete endpoints).
\- 401 - missing/invalid x-api-key.
\- 403 - insufficient balance to enable monitoring for this selection (body: error + estimate).

Idempotency: re-sending an enable returns already_enabled for businesses that are already monitored, with no second screening and no second bill. Disabling an unmonitored business returns disabled and changes nothing.

For end-to-end Didit integration, paste in the full prompt at /integration/integration-prompt.`

\
粘贴到 ## 概述为所选的[企业实体](https://docs.didit.me/zh/entities/businesses/overview.md)启用或禁用[持续 AML 监控](https://docs.didit.me/zh/core-technology/aml-screening/continuous-monitoring-aml-screening.md)，其效果与企业控制台中的 **AML Ongoing monitoring** 操作完全一致。控制台与此 endpoint 运行的是同一套底层逻辑，因此规则、计费和结果均相同。请先发送 `estimate_only: true`，以查看所选企业的数量、需要新建 AML 筛查的企业数量、一次性筛查费用以及每年的监控费用。试运行不会写入任何数据。估算结果使用与用户 endpoint 相同的字段名，因此 `users_total` 表示所选企业的数量。## 企业选择的处理方式- **每家企业只有一次受监控的筛查。** 一家企业即使验证过多次，也只会被监控并计费一次。禁用监控时，会关闭该企业所有筛查的监控。 - **没有 AML 筛查的企业会先进行筛查。** Didit 会为其创建新的 AML 验证（可在企业的 **Verifications** 标签页中查看），并按常规 AML 筛查计费，同时在该验证上启用监控。筛查使用企业的法定名称（或显示名称）和国家/地区。如果企业完全没有名称，则会以 `skipped_no_identity_data` 报告，而不会被静默忽略。 - **沙盒应用从不创建筛查**（`skipped_sandbox`）。 - **会预先检查余额。** 当余额不足以支付估算费用时，启用操作会被拒绝并返回 `403`，响应中包含估算结果，便于您了解需要充值的金额。 - **年度续费。** 新启用监控的企业，将在下一个续费日期按年度监控价格计费，该日期与控制台 **Ongoing monitoring** 列中显示的日期相同。禁用监控会停止续费，但不会退还已计费的周期费用。## 选择范围与批量大小可以通过 `vendor_data_list`、`didit_internal_id_list` 或两者同时选择企业，两个列表之间为"或"的关系。单次请求两个列表合计最多接受 **1000 个标识符**。与您的应用中任何企业都不匹配的标识符，会按原样放入 `unmatched` 返回，且绝不会导致请求失败：如果所选内容没有匹配到任何企业，任务会以空任务完成（`total: 0`），并列出所有标识符，这与批量删除 endpoint 的约定相同。## 同步处理还是后台处理**不超过 20 家企业**的选择会同步处理，调用返回 `200` 以及已完成的任务。超过此数量的选择会返回 `202` 和状态为 `PENDING` 的任务，此时请轮询[获取 AML 监控任务](https://docs.didit.me/zh/management-api/aml-monitoring/get-job.md)，直到 `status` 变为 `COMPLETED` 或 `FAILED`。无论哪种方式，任务都会为每家企业包含一条 `results` 记录，其中带有对应的 `outcome`。| `outcome` | 含义 | | - | - | | `enabled` | 已在现有的 AML 筛查上启用监控。 | | `screened_and_enabled` | 已创建新的 AML 筛查（已计费），并在其上启用监控。 | | `already_enabled` | 监控原本已处于启用状态，未作任何更改，也未计费。 | | `disabled` | 已关闭该企业所有筛查的监控。 | | `skipped_no_identity_data` | 该企业没有可用于筛查的法定名称或显示名称。 | | `skipped_sandbox` | 沙盒应用；不会创建筛查。 | | `failed_provider` | 无法完成筛查。请稍后重试。 | | `failed_insufficient_balance` | 任务运行期间余额耗尽。 |## Webhook切换监控状态本身不会发出任何 Webhook。监控启用后，重新筛查会继续触发[持续 AML 监控](https://docs.didit.me/zh/core-technology/aml-screening/continuous-monitoring-aml-screening.md)中介绍的常规 `status.updated` 和 `data.updated` 事件。## 权限应用的任何有效 API 密钥都可以调用此 endpoint。Didit 的 API 密钥是**应用级别的，而非角色级别的**：控制台中的[角色与权限](https://docs.didit.me/zh/console/roles-permissions.md)决定的是*人员*在控制台中可以执行的操作，对 Management API 的调用不做此类校验。## 相关内容- [获取 AML 监控任务](https://docs.didit.me/zh/management-api/aml-monitoring/get-job.md) - [为用户切换 AML 监控](https://docs.didit.me/zh/management-api/aml-monitoring/toggle-users.md) - [持续 AML 监控](https://docs.didit.me/zh/core-technology/aml-screening/continuous-monitoring-aml-screening.md) - [企业 AML 筛查](https://docs.didit.me/zh/business-verification/aml.md) - [列出企业](https://docs.didit.me/zh/management-api/businesses/list.md) ## OpenAPI ````yaml zh/openapi-25.json POST /v3/businesses/aml-monitoring/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: 身份证件验证 API。使用 x-api-key 请求头进行身份验证。 servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/businesses/aml-monitoring/: post: tags: - AML Ongoing Monitoring summary: 为企业启用或停用持续 AML 监控 description: >- 为所选企业开启或关闭持续 AML 监控，语义与 Business Console 相同。每个企业恰好保留一份受监控的 AML 筛查，因此即使某个档案验证了多次，也仅监控一次并计费一次；禁用则会关闭该档案所有筛查的监控。没有任何 AML 筛查的企业，在具备所需的法定名称或显示名称时会先进行筛查（按常规 AML 筛查计费）；否则将报告为 `skipped_no_identity_data`。 设置 `estimate_only: true` 可预览数量和费用而无需写入任何内容。20 个或更少档案的选择将以内联方式解析，并在任务完成后返回 `200`；更大的选择将返回 `202` 并在后台运行，请使用返回的 `job_id` 轮询 [Get AML monitoring job](#get-/v3/aml-monitoring/jobs/-job_id-/)。当组织余额不足以支付预估费用时，开启操作将被拒绝并返回 `403`。未匹配到任何内容的标识符列在 `unmatched` 中，绝不会导致请求失败：未匹配到任何内容的选择将作为空任务完成（`total` 为 0），这与批量删除 endpoint 的约定一致。 operationId: toggle_businesses_aml_monitoring requestBody: required: true content: application/json: schema: type: object required: - is_enabled description: >- 使用 `vendor_data_list`、`didit_internal_id_list` 或两者同时选择企业（两个列表为“或”逻辑）。两个列表合计每次请求最多 1000 个标识符。 properties: is_enabled: type: boolean description: 为 true 表示启用监控，为 false 表示停用监控。 estimate_only: type: boolean default: false description: 为 true 时，返回费用估算且不执行任何写入：不进行筛查、不计费、不创建任务。 vendor_data_list: type: array items: type: string description: 您要切换的企业自身标识符，完全按照发送的内容进行匹配。 didit_internal_id_list: type: array items: type: string format: uuid description: >- 要切换状态的企业 Didit 内部 ID，即创建、获取和列表 endpoint 返回的 `didit_internal_id`。 examples: Estimate first: summary: 预览费用而不进行写入 value: is_enabled: true estimate_only: true vendor_data_list: - company-123 - company-456 Enable: summary: 为两家企业启用监控 value: is_enabled: true vendor_data_list: - company-123 - company-456 Disable: summary: 按 Didit 内部 ID 禁用监控 value: is_enabled: false didit_internal_id_list: - 3f1c0d3e-8f0a-4c2e-9a3d-9b1f5f4a2c11 responses: '200': description: 估算结果（当 `estimate_only` 为 true 时）或以内联方式处理的选择的已完成任务。 content: application/json: schema: $ref: '#/components/schemas/AMLMonitoringToggleResult' '202': description: 较大的选择集将在后台处理。使用 `job_id` 轮询 job endpoint；随着档案的处理，`results` 会逐步填充。 content: application/json: schema: $ref: '#/components/schemas/AMLMonitoringJob' '400': description: 验证错误：`is_enabled` 缺失、无选择器，或者两个列表中的标识符总数超过 1000 个。 '401': description: API 密钥缺失或无效。 '403': description: 余额不足，无法为此项选择启用监控。响应包含 `estimate`，以便您充值正确的金额。 content: application/json: schema: type: object properties: error: type: string estimate: type: object description: 费用预览。当 estimate_only 为 true 时直接返回（不写入任何内容）。 properties: users_total: type: integer description: 所选条件匹配的档案。 already_enabled: type: integer description: 已处于监控状态的档案（启用时无需操作；禁用时将关闭这些档案的监控）。 with_existing_aml: type: integer description: 现有 AML 筛查将被切换为受监控状态的档案（不进行新的筛查）。 needing_screening: type: integer description: 没有任何 AML 筛查记录、将首先进行筛查的档案（按常规 AML 筛查计费）。 skipped_no_identity_data: type: integer description: 因缺少身份数据而无法进行筛查的档案。 skipped_blocked: type: integer description: 将被跳过的已拉黑用户（对于企业始终为 0）。 estimated_screening_cost_usd: type: number example: 0.2 description: 新增筛查的一次性费用。 estimated_annual_monitoring_cost_usd: type: number example: 0.07 description: 即将纳入监控的档案的年度监控成本。 balance_sufficient: type: boolean description: 组织余额是否足以支付筛查以及第一年的监控费用。 security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: >- curl -X POST 'https://verification.didit.me/v3/businesses/aml-monitoring/' \ -H 'x-api-key: YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{"is_enabled": true, "vendor_data_list": ["company-123", "company-456"]}' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.businesses.set_aml_monitoring( is_enabled=True, estimate_only=True, vendor_data_list=["company-123", "company-456"], ) print(result) - lang: javascript label: Node.js source: |- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); const result = await didit.businesses.setAmlMonitoring({ is_enabled: true, estimate_only: true, vendor_data_list: ["company-123", "company-456"], }); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.Businesses.SetAMLMonitoring(ctx, didit.BusinessesSetAMLMonitoringParams{\n\tIsEnabled: true,\n\tEstimateOnly: didit.Bool(true),\n\tVendorDataList: didit.Some([]string{\"company-123\", \"company-456\"}),\n})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: >- import java.util.List; import me.didit.Didit; import me.didit.types.BusinessesSetAmlMonitoringParams; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.businesses().setAmlMonitoring(BusinessesSetAmlMonitoringParams.builder() .isEnabled(true) .estimateOnly(true) .vendorDataList(List.of("company-123", "company-456")) .build()); System.out.println(result); - lang: php label: PHP source: |- businesses->setAmlMonitoring([ 'is_enabled' => true, 'estimate_only' => true, 'vendor_data_list' => ['company-123', 'company-456'], ]); print_r($result->toArray()); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.businesses.set_aml_monitoring( is_enabled: true, estimate_only: true, vendor_data_list: ["company-123", "company-456"] ) puts result.to_h - lang: csharp label: .NET source: >- using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); var result = await client.Businesses.SetAmlMonitoringAsync(new BusinessesSetAmlMonitoringParams { IsEnabled = true, EstimateOnly = true, VendorDataList = new string[] { "company-123", "company-456" }, }); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: AMLMonitoringToggleResult: oneOf: - type: object required: - users_total - already_enabled - with_existing_aml - needing_screening - skipped_no_identity_data - skipped_blocked - estimated_screening_cost_usd - estimated_annual_monitoring_cost_usd - balance_sufficient - unmatched description: 费用预览。当 estimate_only 为 true 时直接返回（不写入任何内容）。 properties: users_total: type: integer description: 所选条件匹配的档案。 already_enabled: type: integer description: 已处于监控状态的档案（启用时无需操作；禁用时将关闭这些档案的监控）。 with_existing_aml: type: integer description: 现有 AML 筛查将被切换为受监控状态的档案（不进行新的筛查）。 needing_screening: type: integer description: 没有任何 AML 筛查记录、将首先进行筛查的档案（按常规 AML 筛查计费）。 skipped_no_identity_data: type: integer description: 因缺少身份数据而无法进行筛查的档案。 skipped_blocked: type: integer description: 将被跳过的已拉黑用户（对于企业始终为 0）。 estimated_screening_cost_usd: type: number example: 0.2 description: 新增筛查的一次性费用。 estimated_annual_monitoring_cost_usd: type: number example: 0.07 description: 即将纳入监控的档案的年度监控成本。 balance_sufficient: type: boolean description: 组织余额是否足以支付筛查以及第一年的监控费用。 unmatched: type: array items: type: string description: 请求中与该应用中的任何档案均不匹配的标识符，与发送时完全一致。 - type: object required: - job_id - status - is_enabled - target_type - total - processed - outcomes - results - error - created_at - completed_at - estimate - unmatched properties: job_id: type: string format: uuid status: type: string enum: - PENDING - PROCESSING - COMPLETED - FAILED is_enabled: type: boolean description: 当任务启用监控时为 true，停用监控时为 false。 target_type: type: string enum: - user - business description: 该作业切换哪个配置文件系列。 total: type: integer description: 该任务处理的档案。 processed: type: integer description: 截至目前已处理的档案。 outcomes: type: object description: 每条记录的结果计数器。每个选定的个人资料都会准确归入一个计数器；不会静默跳过任何内容。 properties: enabled: type: integer description: 已在现有 AML 筛查上启用监控。 screened_and_enabled: type: integer description: 已创建新的 AML 筛查（已计费）并对其启用了监控。 already_enabled: type: integer description: 监控已处于活动状态；未发生任何更改，也未计费。 disabled: type: integer description: 已在该档案的所有 AML 筛查中关闭监控。 skipped_no_identity_data: type: integer description: 已跳过：资料缺少进行筛查所需的姓名、出生日期和国家/地区（用户）或名称（企业）。 skipped_blocked: type: integer description: 已跳过：用户已被封禁。 skipped_sandbox: type: integer description: 已跳过：沙盒应用，不创建筛查。 failed_provider: type: integer description: 无法完成筛查；请稍后重试。 failed_insufficient_balance: type: integer description: 任务运行时余额耗尽。 results: type: array description: >- 每个已处理的档案对应一个条目，按处理顺序排列。在任务运行期间逐步增加；状态变为 COMPLETED 时完成。仅对通过 API 启动的任务进行记录。 items: type: object properties: didit_internal_id: type: string format: uuid description: 个人资料的 Didit 内部 ID。 vendor_data: type: string nullable: true description: 您为资料指定的自身标识符。 outcome: type: string enum: - enabled - screened_and_enabled - already_enabled - disabled - skipped_no_identity_data - skipped_blocked - skipped_sandbox - failed_provider - failed_insufficient_balance error: type: string nullable: true description: 状态为 FAILED 时的通用失败消息；详细原因保留在平台端。 created_at: type: string format: date-time completed_at: type: string format: date-time nullable: true estimate: type: object description: 费用预览。当 estimate_only 为 true 时直接返回（不写入任何内容）。 properties: users_total: type: integer description: 所选条件匹配的档案。 already_enabled: type: integer description: 已处于监控状态的档案（启用时无需操作；禁用时将关闭这些档案的监控）。 with_existing_aml: type: integer description: 现有 AML 筛查将被切换为受监控状态的档案（不进行新的筛查）。 needing_screening: type: integer description: 没有任何 AML 筛查记录、将首先进行筛查的档案（按常规 AML 筛查计费）。 skipped_no_identity_data: type: integer description: 因缺少身份数据而无法进行筛查的档案。 skipped_blocked: type: integer description: 将被跳过的已拉黑用户（对于企业始终为 0）。 estimated_screening_cost_usd: type: number example: 0.2 description: 新增筛查的一次性费用。 estimated_annual_monitoring_cost_usd: type: number example: 0.07 description: 即将纳入监控的档案的年度监控成本。 balance_sufficient: type: boolean description: 组织余额是否足以支付筛查以及第一年的监控费用。 unmatched: type: array items: type: string description: 请求中与该应用中的任何档案均不匹配的标识符，与发送时完全一致。它们不属于任务的一部分。 AMLMonitoringJob: type: object properties: job_id: type: string format: uuid status: type: string enum: - PENDING - PROCESSING - COMPLETED - FAILED is_enabled: type: boolean description: 当任务启用监控时为 true，停用监控时为 false。 target_type: type: string enum: - user - business description: 该作业切换哪个配置文件系列。 total: type: integer description: 该任务处理的档案。 processed: type: integer description: 截至目前已处理的档案。 outcomes: type: object description: 每条记录的结果计数器。每个选定的个人资料都会准确归入一个计数器；不会静默跳过任何内容。 properties: enabled: type: integer description: 已在现有 AML 筛查上启用监控。 screened_and_enabled: type: integer description: 已创建新的 AML 筛查（已计费）并对其启用了监控。 already_enabled: type: integer description: 监控已处于活动状态；未发生任何更改，也未计费。 disabled: type: integer description: 已在该档案的所有 AML 筛查中关闭监控。 skipped_no_identity_data: type: integer description: 已跳过：资料缺少进行筛查所需的姓名、出生日期和国家/地区（用户）或名称（企业）。 skipped_blocked: type: integer description: 已跳过：用户已被封禁。 skipped_sandbox: type: integer description: 已跳过：沙盒应用，不创建筛查。 failed_provider: type: integer description: 无法完成筛查；请稍后重试。 failed_insufficient_balance: type: integer description: 任务运行时余额耗尽。 results: type: array description: >- 每个已处理的档案对应一个条目，按处理顺序排列。在任务运行期间逐步增加；状态变为 COMPLETED 时完成。仅对通过 API 启动的任务进行记录。 items: type: object properties: didit_internal_id: type: string format: uuid description: 个人资料的 Didit 内部 ID。 vendor_data: type: string nullable: true description: 您为资料指定的自身标识符。 outcome: type: string enum: - enabled - screened_and_enabled - already_enabled - disabled - skipped_no_identity_data - skipped_blocked - skipped_sandbox - failed_provider - failed_insufficient_balance error: type: string nullable: true description: 状态为 FAILED 时的通用失败消息；详细原因保留在平台端。 created_at: type: string format: date-time completed_at: type: string format: date-time nullable: true estimate: type: object description: 费用预览。当 estimate_only 为 true 时直接返回（不写入任何内容）。 properties: users_total: type: integer description: 所选条件匹配的档案。 already_enabled: type: integer description: 已处于监控状态的档案（启用时无需操作；禁用时将关闭这些档案的监控）。 with_existing_aml: type: integer description: 现有 AML 筛查将被切换为受监控状态的档案（不进行新的筛查）。 needing_screening: type: integer description: 没有任何 AML 筛查记录、将首先进行筛查的档案（按常规 AML 筛查计费）。 skipped_no_identity_data: type: integer description: 因缺少身份数据而无法进行筛查的档案。 skipped_blocked: type: integer description: 将被跳过的已拉黑用户（对于企业始终为 0）。 estimated_screening_cost_usd: type: number example: 0.2 description: 新增筛查的一次性费用。 estimated_annual_monitoring_cost_usd: type: number example: 0.07 description: 即将纳入监控的档案的年度监控成本。 balance_sufficient: type: boolean description: 组织余额是否足以支付筛查以及第一年的监控费用。 unmatched: type: array items: type: string description: 请求中与该应用中的任何档案均不匹配的标识符，与发送时完全一致。它们不属于任务的一部分。 securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- 您的应用 API 密钥，可在 Business Console 的“开发者 -> API 密钥”中获取。主密钥拥有完整访问权限。指定名称的密钥可设置作用域：针对每个资源设为无权限、只读或读写，限定于特定工作流或已通过的会话、限定于 IP 地址列表，以及设置到期日期。401 表示密钥错误、已撤销或已过期；403 表示未发送密钥、密钥无权访问该资源或操作，或请求来自其 IP 列表之外的地址；在会话路由上返回 404 表示该会话不在该密钥允许的工作流或状态范围内。没有媒体访问权限的密钥获取到的图片、视频和 PDF URL 将为 null；没有会话写入权限的密钥获取到的会话链接和 token 将为 null。请参阅 https://docs.didit.me/console/api-keys。 ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.