合作方API

更新: 2017-11-8

API域名

Host: yk3-api.gokuai.com

开通企业

POST /1/thirdparty/create_ent HTTP/1.1

请求参数

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

扩展参数

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

返回

成功 HTTP 200

{
  "id": 企业唯一ID,
  "username": 管理员帐号,
  "password": 管理员密码
}

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


获取企业信息

POST /1/thirdparty/ent_info HTTP/1.1

请求参数

参数 必需 说明
client_id 够快分配的client_id
out_id 企业在合作方系统中的唯一ID
dateline 当前unix时间戳, 单位秒
sign 签名

返回格式

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 够快分配的client_id
out_id 企业在合作方系统中的唯一ID
dateline 当前unix时间戳, 单位秒
sign 签名

购买时参数

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

续费时参数

参数 必需 说明
type 固定值renew
month 续费月数

升级时参数

参数 必需 说明
type 固定值upgrade
member_count 新增人数(不限是-1)
space 新增空间(G)

退订参数

参数 必需 说明
type 固定值unsubscribe

返回

成功 HTTP 200