使用 /vault 终端存储账户凭证,例如云存储凭证或 Play Store 密钥。App Automation 在将设置从模板应用迁移到其他应用时会使用这些凭证,因此无需在每次请求中重复发送。
您存储的数据均经过加密。API 绝不会以明文形式返回这些数据。
工作原理
- Vault 记录归您的账户所有。账户中的所有应用均可使用这些记录,其他账户则无法读取。
- 每条记录由
section和store标识。为已存在的section和store组合存储数据时,会覆盖该记录的现有数据。 - API 仅以加密形式返回每条记录的
data。如果之后需要查看凭证,请自行备份。
使用 Vault 的应用部分
以下应用部分会在迁移过程中从 Vault 读取凭证:
| 应用部分 | store | 存储内容 data | 使用场景 |
|---|---|---|---|
csv_upload_settings | 省略 | 包含云存储凭证的 JSON 字符串。请参阅“CSV 上传凭证”。 | 目标应用尚未配置云存储凭证。此应用部分只能存储一条记录。 |
purchase_verification | google | Play Store 密钥,以字符串形式存储。 | 目标应用为 Android 应用。 |
无法为app_info 和 signature 这两个部分存储数据。
CSV 上传凭证
对于 csv_upload_settings,data 是一个 JSON 字符串。具体内容取决于所使用的存储类型。
Amazon S3
| 参数 | 数据类型 | 必要参数 | 描述 |
|---|---|---|---|
type | String | 是 | 必须为 S3。 |
bucket | String | 是 | 存储桶名称。 |
key | String | 是 | 访问密钥 ID。 |
secret | String | 是 | 秘密访问密钥。 |
region | String | 否 | 存储桶所在的 AWS 区域。 |
Google Cloud Storage
| 参数 | 数据类型 | 必要参数 | 描述 |
|---|---|---|---|
type | String | 是 | 必须为 GCS。 |
bucket | String | 是 | 存储桶名称。 |
secret | Object | 是 | JSON 对象形式的服务账号密钥。 |
创建或更新 Vault 记录
存储指定应用部分的凭证。如果相同 section 和 store 的记录已存在,其数据将被覆盖。
API 协议
终端: https://automate.adjust.com/app-automation/vault
方法: POST
请求正文: Vault 创建请求
响应: Vault 记录
示例
存储用于 CSV 上传的 Amazon S3 凭证
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 --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 --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。 |
store | String | 凭证所属的商店。其中任一:google,itunes。如果凭证并非特定于商店,请将其省略。 |
data* | String | 要存储的凭证。API 会在保存前加密该值。 |
Vault 记录
| 参数 | 数据类型 | 描述 |
|---|---|---|
id* | Integer | 记录 ID。 |
account_id* | Integer | 该记录所属账户的 ID。 |
section* | String | 凭证对应的应用部分。 |
store | String | 凭证对应的商店是:google 或 itunes。未设置时为 null。 |
data* | String | 以加密形式存储的凭证。API 绝不会以明文形式返回这些数据。 |
created_at* | String | 记录创建时的日期时间 (ISO 格式)。 |