注册用户
https://cnapi.ttlock.com/v3/user/register
注意:已经在通通锁APP里注册了用户账号,则不需要再调用注册用户接口,可以直接用APP账号和密码获取访问令牌 。
开发者的系统自己维护用户信息,并且不希望暴露自己系统的用户信息给通通锁平台,可以通过在云端注册一个用户账号和开发者的系统里的账号做关联。
例如:
(1)用户通过手机号(18876191902)在开发者的系统里注册了一个账号;
(2)开发者调用该接口在云端注册一个用户,username参数传一个随机字符串:c042f4db68f23406c6cecf84a7ebb0fe,云端会生成一个带前缀的用户账号:abcd_c042f4db68f23406c6cecf84a7ebb0fe,前缀abcd_是创建应用时随机分配的,用来做命名空间隔离不同应用的用户,没有任何别的意义,不允许定制和修改;
(3)开发者在自己的系统里维护18876191902账号和云端abcd_c042f4db68f23406c6cecf84a7ebb0fe账号的对应关系;
(4)当用户18876191905要访问云端接口时,用abcd_c042f4db68f23406c6cecf84a7ebb0fe账号获取访问令牌 。
1 HTTP请求方法及示例
POST, ContentType:application/x-www-form-urlencoded
javascript
curl --location -g --request POST 'https://cnapi.ttlock.com/v3/user/register' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'clientId=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' \
--data-urlencode 'clientSecret=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' \
--data-urlencode 'username=c042f4db68f23406c6cecf84a7ebb0fe' \
--data-urlencode 'password=e10adc3949ba59abbe56e057f20f883e' \
--data-urlencode 'date=1625019027000'2 参数说明
| 名称 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
| clientId | String | Y | 创建应用分配的client_id |
| clientSecret | String | Y | 创建应用分配的client_secret |
| username | String | Y | 用户账号,只能包含数字和字母,注意云端生成的账号会加前缀,请使用云端返回的username获取访问令牌 |
| password | String | Y | 账号密码(32位小写md5 加密) |
| date | Long | Y | 当前时间(时间戳,单位毫秒) |
3 返回参数及示例
| 参数 | 类型 | 描述 |
|---|---|---|
| username | String | 请使用云端返回的username获取访问令牌 |
{
"username": "abcd_c042f4db68f23406c6cecf84a7ebb0fe"
}