账户与关联
获取账户
GET /api/v1/accounts/{phone}
{
"phone": "+228XXXXXXXX",
"state": "claimed",
"display_name": "Ama K.",
"partners": [{ "code": "seed", "name": "SEED" }]
}
关联 / 邀请
POST /api/v1/accounts/link
{
"phone": "+228XXXXXXXX",
"invite": true
}
此操作会创建或获取账户,将其关联到您的合作伙伴组织,并可发送 SMS 邀请,让用户认领 MorisBox 账户。
服务提供方字段
合作伙伴可要求用户在关联时填写自定义字段(例如参保人编号):
| 端点 | 用途 |
|---|---|
GET /api/v1/settings/account-fields | 列出字段定义 |
POST /api/v1/settings/account-fields | 创建字段 |
PATCH /api/v1/settings/account-fields/{id} | 更新字段 |
DELETE /api/v1/settings/account-fields/{id} | 删除字段 |
字段类型包括 char、date、selection 等。
E2E 密钥(可选)
GET /api/v1/keys/{phone} - 启用加密消息时使用的设备公钥。