合作方API

更新: 2016-7-20

API域名

Host: yk3.gokuai.com

开通企业

POST /1/thirdparty/create_ent HTTP/1.1

请求参数

参数 必须 类型 说明
client_id string 够快分配的client_id
out_id string 企业在合作方系统中的唯一ID
ent_name string 企业名称
contact_name string 企业联系人姓名
contact_mobile string 企业联系电话
contact_email string 企业联系邮箱
contact_address string 企业联系地址
dateline long unix当前时间戳
sign string 签名

扩展参数

用于传递一些特殊用途的企业初始数据, 参数前缀为__setting_, 例如: __setting_site_url

返回

成功 HTTP 200

如果企业名称在够快中已存在, 系统会自动在企业名称后加4个随机数字


获取企业信息

POST /1/thirdparty/ent_info HTTP/1.1

请求参数

参数 必须 类型 说明
client_id string 够快分配的client_id
out_id string 企业在合作方系统中的唯一ID
dateline long unix当前时间戳
sign string 签名

返回格式

json

返回结果

{
  "id": 企业ID,
  "name": 企业名称,
  "trial": 是否试用, 1表示试用, 0表示正式开通,
  "end_dateline": 到期时间, unix时间戳,
  "member_limit": 成员数量上限,
  "member_count": 成员数量,
  "space": 空间上限, 单位字节,
  "size": 已使用空间, 单位字节
}

下订单

POST /1/thirdparty/order HTTP/1.1

需够快授权代理商才能调用。操作立即生效。

请求公共参数

参数 必须 类型 说明
client_id string 够快分配的client_id
out_id string 企业在合作方系统中的唯一ID
dateline long unix当前时间戳
sign string 签名

购买时参数

参数 必须 类型 说明
type string 固定值'subscribe'
member_count int 人数(不限是-1)
space int 空间(G)
month int 购买的月数

续费时参数

参数 必须 类型 说明
type string 固定值'renew'
month int 续费月数

升级时参数

参数 必须 类型 说明
type string 固定值'upgrade'
member_count int 新增人数(不限是-1)
space int 新增空间(G)

退订参数

参数 必须 类型 说明
type string 固定值'unsubscribe'

返回

成功 HTTP 200