adjust-icon

Vault 终端

使用 /vault 终端存储账户凭证,例如云存储凭证或 Play Store 密钥。App Automation 在将设置从模板应用迁移到其他应用时会使用这些凭证,因此无需在每次请求中重复发送。

您存储的数据均经过加密。API 绝不会以明文形式返回这些数据。

工作原理

  • Vault 记录归您的账户所有。账户中的所有应用均可使用这些记录,其他账户则无法读取。
  • 每条记录由 section 和 store 标识。为已存在的 section 和 store 组合存储数据时,会覆盖该记录的现有数据。
  • API 仅以加密形式返回每条记录的 data。如果之后需要查看凭证,请自行备份。

使用 Vault 的应用部分

以下应用部分会在迁移过程中从 Vault 读取凭证:

应用部分store存储内容 data使用场景
csv_upload_settings省略包含云存储凭证的 JSON 字符串。请参阅“CSV 上传凭证”。目标应用尚未配置云存储凭证。此应用部分只能存储一条记录。
purchase_verificationgooglePlay Store 密钥,以字符串形式存储。目标应用为 Android 应用。

无法为app_info 和 signature 这两个部分存储数据。

CSV 上传凭证

对于 csv_upload_settings,data 是一个 JSON 字符串。具体内容取决于所使用的存储类型。

Amazon S3

参数数据类型必要参数描述
typeString是必须为 S3。
bucketString是存储桶名称。
keyString是访问密钥 ID。
secretString是秘密访问密钥。
regionString否存储桶所在的 AWS 区域。

Google Cloud Storage

参数数据类型必要参数描述
typeString是必须为 GCS。
bucketString是存储桶名称。
secretObject是JSON 对象形式的服务账号密钥。

创建或更新 Vault 记录

存储指定应用部分的凭证。如果相同 section 和 store 的记录已存在,其数据将被覆盖。

API 协议

终端: https://automate.adjust.com/app-automation/vault

方法: POST

请求正文: Vault 创建请求

响应: Vault 记录

示例

存储用于 CSV 上传的 Amazon S3 凭证

请求 - cURL
curl --location 'https://automate.adjust.com/app-automation/vault' \
--header 'Authorization: Bearer {your-adjust-api-token}' \
--header 'Content-Type: application/json' \
--data '{
"section": "csv_upload_settings",
"data": "{\"type\": \"S3\", \"bucket\": \"my-export-bucket\", \"key\": \"{access-key-id}\", \"secret\": \"{secret-access-key}\", \"region\": \"eu-central-1\"}"
}'
响应
{
"id": 1,
"account_id": 12345,
"section": "csv_upload_settings",
"store": null,
"data": "{encrypted-data}",
"created_at": "2026-10-01T09:30:00"
}

存储用于购买验证的 Play Store 密钥

请求 - cURL
curl --location 'https://automate.adjust.com/app-automation/vault' \
--header 'Authorization: Bearer {your-adjust-api-token}' \
--header 'Content-Type: application/json' \
--data '{
"section": "purchase_verification",
"store": "google",
"data": "{play-store-key}"
}'

错误

状态代码描述
400该部分不受支持。无法为 app_info 或 signature 存储数据。
422请求正文无效。例如,section 或 store 的值不受支持,或者缺少 data。

获取 Vault 记录

获取账户中的所有 Vault 记录。每条记录的 data 均经过加密。

API 协议

终端: https://automate.adjust.com/app-automation/vault

方法: GET

响应: Vault 记录数组

示例

请求 - cURL
curl --location 'https://automate.adjust.com/app-automation/vault' \
--header 'Authorization: Bearer {your-adjust-api-token}'
响应
[
{
"id": 1,
"account_id": 12345,
"section": "csv_upload_settings",
"store": null,
"data": "{encrypted-data}",
"created_at": "2026-10-01T09:30:00"
},
{
"id": 2,
"account_id": 12345,
"section": "purchase_verification",
"store": "google",
"data": "{encrypted-data}",
"created_at": "2026-10-01T09:32:00"
}
]

数据模型

Vault 创建请求

参数数据类型描述
section*String凭证适用的应用部分。不支持 app_info 和 signature。
storeString凭证所属的商店。其中任一:google,itunes。如果凭证并非特定于商店,请将其省略。
data*String要存储的凭证。API 会在保存前加密该值。

Vault 记录

参数数据类型描述
id*Integer记录 ID。
account_id*Integer该记录所属账户的 ID。
section*String凭证对应的应用部分。
storeString凭证对应的商店是:google 或 itunes。未设置时为 null。
data*String以加密形式存储的凭证。API 绝不会以明文形式返回这些数据。
created_at*String记录创建时的日期时间 (ISO 格式)。