创建登录凭证
接口描述
创建应用访问接口所需的凭证,目前支持三种授权方式:用户授权 所需参数app_id
,token
。应用授权所需参数app_id
,application_id
,application_secret
。分享授权 所需参数:share_id
,secret
。
请求URI
/ticket
HTTP Method
POST
参数说明
参数名称 | 是否必填 | 参数说明 |
---|---|---|
app_id | true | 应用实例ID |
token | false | 用户授权凭证 |
application_id | false | 应用ID |
application_secret | false | 应用私钥 |
share_id | false | 分享实例ID |
secret | false | 分享实例密钥 |
expired | false | 有效时间(秒) |
响应结果说明
名称 | 说明 |
---|
请求示例
POST /v2/ticket HTTP/1.1
Host: api.huoban.com
Content-Type: application/json
Authorization: Bearer {YOUR ACCESS TOKEN}
{
"app_id": 1000,
"token": "cH2X3MtnJy7bAb77JxgtrNdT776Cgy",
"application_id": 11002,
"application_secret": "oAtKf7asFNf27*yu",
"share_id": 4500,
"secret": "31f8jwer834j234fsdjv7217bAb77Jxg",
"expired": 86400
}
响应示例
HTTP/1.1 200 OK
Content-Type: application/json
{
"ticket": "cH2X3MtnJy7bAb77JxgtrNdT776CgyBL",
"expire_at": "2016-10-23 00:00:00",
"expired": 86400
}
解析ticket信息
接口描述
解析ticket,根据ticket类型,返回ticket的具体信息。目前支持三种授权方式:用户授权 参数app_id
,token
。应用授权参数app_id
,application_id
,application_secret
。分享授权 参数:share_id
,secret
。
请求URI
/ticket/parse
HTTP Method
GET
参数说明
参数名称 | 是否必填 | 参数说明 |
---|
响应结果说明
名称 | 说明 |
---|---|
table | 表格实例,简单参数,详情请参照table |
user | 用户实例,简单参数,详情请参照user |
application | 应用实例,简单参数,详情请参照application |
share | 分享实例,简单参数,详情请参照share |
请求示例
GET /v2/ticket/parse HTTP/1.1
Host: api.huoban.com
Content-Type: application/json
Authorization: Bearer {YOUR ACCESS TOKEN}
响应示例
HTTP/1.1 200 OK
Content-Type: application/json
{
"table": {
"table_id": 11001,
"name": "表格名称",
"icon": {
"id": 600,
"color": "a",
"rgb": "#66BB6A"
},
"item_name": "数据名称"
},
"user": {
"user_id": 11001,
"name": "张三",
"avatar": "http:\/\/avatar.image.url"
},
"application": {
"application_id": 11001,
"name": "名字",
"icon": "http:\/\/application.icon.url"
},
"share": {
"share_id": 11001
}
}