跳转到主要内容
POST
cURL
当你需要在同一组织内分离验证流量、凭证、品牌设置或报表时,请使用此 endpoint。 这对于为每位客户创建一个应用的经销商尤其有用。当你的公司拥有多个产品、品牌、地区、预发布/生产环境,或某些使用场景不应共享同一 API 密钥和应用级设置时,此 endpoint 同样适用。
所有 Auth API endpoint 均使用 https://apx.didit.me/auth/v2。调用 https://verification.didit.me/v3/... endpoint(例如会话和工作流)时,请将返回的 api_key 作为 x-api-key 使用。

数据位置

每个应用都会将其验证数据存储并处理在一个位置,即其数据位置;该位置在创建应用时通过 data_location 选择。 目前唯一可用的位置是 eu,即欧盟(爱尔兰)。若省略该字段,则默认使用此位置。 澳大利亚(悉尼,au)和墨西哥(mx)即将推出。若请求中指定这些位置,将返回 400 This data location is not available yet.,且不会创建应用。 读取应用时都会返回其 data_location,且应用创建后无法更改该位置。 详见 数据位置。

授权

Authorization
string
header
必填

由 POST /programmatic/login/ 或 POST /programmatic/verify-email/ 返回的 RS256 签名 JWT access_token。作为 Authorization: Bearer <access_token> 发送。默认有效期为 86400 秒(24 小时)。该 token 仅对 apx.didit.me/auth/v2 上的账户管理 endpoint 有效。验证 API(verification.didit.me/v3)改用长效的 api_key 作为 x-api-key。

路径参数

org_id
string<uuid>
必填

组织的 UUID。使用 GET /organizations/me/ 查询。

示例:

"a1b2c3d4-5678-90ab-cdef-111111111111"

请求体

application/json

所有字段均为可选。省略请求体将创建一个默认名称为 "<organization name> App" 且未配置公开 URL 的应用。

所有字段均为可选。发送空请求体将在欧盟地区创建一个包含默认名称的应用。

name
string

应用显示名称。默认为 "<organization name> App"。

示例:

"Acme Customer App"

website_url
string

与此应用关联的网站或应用 URL。

示例:

"https://acme.example"

redirect_uris
string[]

OAuth 风格及验证重定向流程允许的重定向 URI。

示例:
terms_url
string

在验证流程中显示的服务条款 URL。

示例:

"https://acme.example/terms"

privacy_url
string

在验证流程中显示的隐私政策 URL。

示例:

"https://acme.example/privacy"

description
string

应用的内部描述(不对终端用户显示)。

data_location
enum<string>

应用验证数据的存储和处理位置,在创建应用时选择。eu 为欧盟(爱尔兰),即默认值。au(澳大利亚,悉尼)和 mx(墨西哥)即将推出:指定这些位置的请求将返回 400 This data location is not available yet.。组织的沙盒应用始终位于欧盟。

可用选项:
eu,
au,
mx
示例:

"eu"

响应

应用已创建。响应包含长期有效的 api_key;请立即将其持久化保存,并在每次调用 https://verification.didit.me/v3/... 时将其用作 x-api-key 请求头。

完整应用记录。uuid、client_id 和 api_key 在创建后永不更改。data_location 同样不会更改,除非在随您的组织创建的生产环境应用被投入使用之前修改一次(参见更新请求)。

uuid
string<uuid>

应用 UUID。在后续调用中用作 {app_id}。

示例:

"b2c3d4e5-6789-01bc-defg-222222222222"

name
string

在 Didit 控制台中显示的应用显示名称。

示例:

"Acme Production App"

client_id
string

公开客户端标识符,可安全嵌入 OAuth 风格的流程中。

示例:

"S9LIYGSoWNuGMLHsvEt9dQ"

api_key
string

长期有效的密钥(也称为 client_secret)。在对 https://verification.didit.me/v3/... 的每次调用(会话、工作流、AML 等)中作为 x-api-key 请求头使用。请妥善作为凭据保管,切勿在客户端暴露。新密钥以 sk_live_(生产环境应用)或 sk_test_(沙盒应用)开头,后接 43 个 URL 安全字符(字母、数字、- 和 _)。在此格式之前创建的密钥没有前缀,仍可继续使用。在恢复账户后的 72 小时内,此处的列表、检索和更新接口将返回空字符串而不是密钥。

示例:

"sk_live_example_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

website_url
string | null

与此应用关联的网站或应用 URL。

示例:

"https://acme.example"

redirect_uris
string[]

OAuth 风格及验证重定向流程允许的重定向 URI。

示例:
terms_url
string | null

在验证流程中显示的服务条款 URL。

示例:

"https://acme.example/terms"

privacy_url
string | null

在验证流程中显示的隐私政策 URL。

示例:

"https://acme.example/privacy"

description
string | null

应用的内部描述(不对终端用户显示)。

created_at
string<date-time>
示例:

"2025-06-01T10:00:00Z"

data_location
enum<string>

应用验证数据的存储和处理位置,在创建应用时选择。eu 为欧盟(爱尔兰),即默认值。au(澳大利亚,悉尼)和 mx(墨西哥)即将推出:指定这些位置的请求将返回 400 This data location is not available yet.。组织的沙盒应用始终位于欧盟。

可用选项:
eu,
au,
mx
示例:

"eu"

products
object[]
read-only

该应用的产品。始终包含全部三项,顺序如下:identity、transactions、authentication。新创建的应用会默认启用 identity 及其所有模块,并禁用 transactions 和 authentication。只读:创建或更新请求体中的 products 键将被忽略。

示例:
最后修改于 2026年11月7日