家庭分享管理

更新时间:2024-06-05 03:15:11下载pdf

添加分享

接口说明

生成家庭分享票据,用于邀请成员加入家庭。

接口地址

action: sharing.homeTicket

params 请求参数

参数名 类型 说明 是否必填
home_id Long 家庭 ID
sharer String 分享人账号
receiver String 接受人账号,不填则为二维码分享
app_schema String 涂鸦渠道标识符,填入 cloud 即可

响应参数

参数名 类型 说明
code Integer 响应码(详情见错误码章节)
success Boolean 是否成功:
- true:成功
- false:失败
msg String 请求失败的信息,成功为空
result Object 结果

result 说明

参数名 类型 说明
sharing_id String 分享 ID
sharing_ticket String 分享票据,一次有效
expire_time Long 失效时间,单位:秒

请求示例

{
    "action": "sharing.homeTicket",
    "params": {
        "home_id": 10001,
    "sharer": "ay15309353754999xY2T",
    "app_schema": "xxxxxx"
    }
}

响应示例

{
    "result": {
      "sharing_id": 5003,
      "sharing_ticket": "3ce76bc4f8ef36f5a709043b49175ad8",
      "expire_time": 300
    },
    "t":1540799929837,
    "success": true
}

错误码

以下为该接口常见的业务异常,更多的异常错误,请参见《全局错误码》。

错误码 说明
500 系统错误
1106 权限非法

家庭分享票据校验

接口说明

校验家庭分享的临时票据是否有效。

接口地址

action: sharing.homeTicketVerification

params 请求参数

参数名 类型 说明 是否必填
sharing_ticket String 分享票据

响应参数

参数名 类型 说明
code Integer 响应码(详情见错误码章节)
success Boolean 是否成功:
- true:成功
- false:失败
msg String 请求失败的信息,成功为空
result Object 结果

result 说明

参数名 类型 说明
sharing_id String 分享 ID
sharing_ticket String 分享票据,一次有效
expire_time Long 失效时间,单位:秒

请求示例

{
    "action": "sharing.homeTicketVerification",
    "params": {
    "sharing_ticket": "3ce76bc4f8ef36f5a709043b49175ad8"
    }
}

响应示例

{
    "result": {
      "sharing_id": 5003,
      "sharing_ticket": "3ce76bc4f8ef36f5a709043b49175ad8",
      "expire_time": 300
    },
    "t":1540799929837,
    "success": true
}

错误码

以下为该接口常见的业务异常,更多的异常错误,请参见《全局错误码》。

错误码 说明
500 系统错误
1106 权限非法
2703 分享票据过期

加入分享

接口说明

受邀人确认加入家庭分享。

接口地址

action: sharing.homeConfirm

请求参数

参数名 类型 说明 是否必填
sharing_id Long 分享 ID
sharing_ticket String 分享票据
receiver String 接受者账号
app_schema String 涂鸦渠道标识符,填入 cloud 即可

响应参数

参数名 类型 说明
code Integer 响应码(详情见错误码章节)
success Boolean 是否成功:
- true:成功
- false:失败
msg String 请求失败的信息,成功为空
result Boolean 确认结果

请求示例

{
    "action": "sharing.homeConfirm",
    "params": {
        "sharing_id": 5003,
    "sharing_ticket": "3ce76bc4f8ef36f5a709043b49175ad8",
    "receiver": "ay15309353754xxxxxx",
    "app_schema": "xxxxxxx"
    }
}

响应示例

{
    "success":true,
    "t":1540799929837,
    "result":true
}

错误码

以下为该接口常见的业务异常,更多的异常错误,请参见《全局错误码》。

错误码 说明
500 系统错误
1106 权限不足
2703 分享票据过期

取消分享

接口说明

管理员取消分享邀请。

接口地址

action: sharing.homeCancel

请求参数

参数名 类型 说明 是否必填
sharing_id Long 分享邀请 ID

响应参数

参数名 类型 说明
code Integer 响应码(详情见错误码章节)
success Boolean 是否成功:
- true:成功
- false:失败
msg String 请求失败的信息,成功为空
result Boolean 返回结果

请求示例

{
    "action": "sharing.homeCancel",
    "params": {
        "sharing_id": 5003
    }
}

响应示例

{
    "success":true,
    "t":1540799929837,
    "result":true
}

错误码

以下为该接口常见的业务异常,更多的异常错误,请参见《全局错误码》。

错误码 说明
500 系统错误
1106 权限不足