创建登录凭证

接口描述

创建应用访问接口所需的凭证,目前支持三种授权方式:用户授权 所需参数app_idtoken应用授权所需参数app_idapplication_idapplication_secret分享授权 所需参数:share_idsecret

请求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_idtoken应用授权参数app_idapplication_idapplication_secret分享授权 参数:share_idsecret

请求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
  }
}