client/docs/cloud/share.md

Share

分享服务

• /cloud.Share/CreateShare
• /cloud.Share/GetShare
• /cloud.Share/DeleteShare
• /cloud.Share/ListShares
• /cloud.Share/ValidateSharePassword

/cloud.Share/CreateShare

创建分享

Request

{
    cloud_id: "0", // type<uint64>
    cloud_identity: "", // type<string>
    share_type: "", // type<string>, file, album, note, etc.
    resource_id: "0", // type<uint64>, 对应资源的ID
    share_token: "", // type<string>, 分享令牌
    password: "", // type<string>, 可选分享密码
    expires_at: "", // type<string>, 过期时间
    is_public: false, // type<bool>, 是否公开
}

Reply

{
    data: "", // type<string>, 数据
    timeseq: "0", // type<int64>, 响应时间序列
}

/cloud.Share/GetShare

获取分享详情

Request

{
    id: "0", // type<int64>, 唯一ID
    identity: "", // type<string>, 唯一码
}

Reply

{
    id: "0", // type<uint64>
    identity: "", // type<string>
    share_type: "", // type<string>, file, album, note, etc.
    resource_id: "0", // type<uint64>, 对应资源的ID
    share_token: "", // type<string>, 分享令牌
    password: "", // type<string>, 可选分享密码
    expires_at: "", // type<string>, 过期时间
    view_count: 0, // type<int32>, 浏览次数
    download_count: 0, // type<int32>, 下载次数
    is_public: false, // type<bool>, 是否公开
    created_at: "", // type<string>
    updated_at: "", // type<string>
}

/cloud.Share/DeleteShare

删除分享

Request

{
    id: "0", // type<int64>, 唯一ID
    identity: "", // type<string>, 唯一码
}

Reply

{
    data: "", // type<string>, 数据
    timeseq: "0", // type<int64>, 响应时间序列
}

/cloud.Share/ListShares

获取分享列表

Request

{
    page_no: "0", // type<int64>, 页数
    page_size: "0", // type<int64>, 每页记录数
    params: {
        "": ""
    }, // map<string,string>, 条件参数,key=val,eg key:category_id=?,vlaue=11 
}

Reply

{
    shares: [{
        id: "0", // type<uint64>
        identity: "", // type<string>
        share_type: "", // type<string>, file, album, note, etc.
        resource_id: "0", // type<uint64>, 对应资源的ID
        share_token: "", // type<string>, 分享令牌
        password: "", // type<string>, 可选分享密码
        expires_at: "", // type<string>, 过期时间
        view_count: 0, // type<int32>, 浏览次数
        download_count: 0, // type<int32>, 下载次数
        is_public: false, // type<bool>, 是否公开
        created_at: "", // type<string>
        updated_at: "", // type<string>
    }], // list<CloudShareItem>
    total: "0", // type<int64>
}

/cloud.Share/ValidateSharePassword

验证分享密码

Request

{
    identity: "", // type<string>
    password: "", // type<string>
}

Reply

{
    data: "", // type<string>, 数据
    timeseq: "0", // type<int64>, 响应时间序列
}