跳转到主要内容
GET
cURL

授权

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。

示例:

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

app_id
string<uuid>
必填

您想要读取其凭据的应用的 UUID。

示例:

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

响应

包含其 client_id 和 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日