（应用平台）VPaas平台PHP API接口文档

VPaas组件化 应用平台

更新历史

目录

1. 对接方式、鉴权认证

凡是要使用应用能力的接口，双方需通过对比加密sign值，进行安全校验，否则接口不能使用。

加密算法：
sign = md5(shal(appid + time + random) + key);

成功样例
http://app.sewise.com/v1/app/info?appid=ic89rf8705ztf6uip7&time=1481600689&sign=818b8ca06a1dc4811d25983d6b19bfc3&random=123456

2. 全局返回码说明

每次调用接口时，可能获得正确或错误的返回码，开发者可以根据返回码信息调试接口，排查错误。

HTTP请求状态返回格式

错误样例
{
"status": 40013,
"message": {"0":"invalid appid"}
}
成功样例
{
"status": 200,
"data": {"access_token":"ACCESS_TOKEN","expires_in":7200}
}

1.应用平台

1.1 创建应用

接口地址

/v1/app/create

HTTP Content-Type / 请求方式

application/json
POST

请求参数

参数	必选	类型	说明
RequestBody
userId	是	Int	用户uid
name	是	String	应用名称
type	是	Int	类型 1.普通，2.内容商，3.开发商，4.平台（需传token）

HTTP 响应状态

200

接口示例

Request
curl -X POST -H "Content-Type:application/json" -d {"userId":"13"，"name":"应用宝","type":"1"} http://app.sewise.com/v1/app/create
Response
{"status":200,"data":{"id":"31"}}

1.2 获取授权

接口地址

/v1/app/token

HTTP Content-Type / 请求方式

application/json
POST

请求参数

参数	必选	类型	说明
RequestBody
appId	是	String	应用appId
appSecret	是	String	应用appSecret

HTTP 响应状态

200

接口示例

Request
curl -X POST -H "Content-Type:application/json" -d {"appId":"ic89rf8705ztf6uip7"，"appSecret":"82n7n4iow01sfmzwjpfuo120v5n7erta"} http://app.sewise.com/v1/app/token
Response
{
"status": 200,
"data": {
"access_token": "bSjHgdh43NRbxZ9fOrTtjipynmcIh74fUr8u4Rnd",
"expire": "2016-12-23 17:55:54"
}
}

1.3 获取应用基本信息

接口地址

/v1/app/info

HTTP Content-Type / 请求方式

application/json
GET/POST

请求参数

参数	必选	类型	说明
RequestBody
appid	是	String	应用appID
time	是	int	时间戳
random	否	int	随机数
sign	是	String	加密值

或

参数	必选	类型	说明
RequestBody
token	是	String	授权码

HTTP 响应状态

200

接口示例

Request
curl -X POST -H "Content-Type:application/json" -d http://app.sewise.com/v1/app/info?appid=ic89rf8705ztf6uip7&time=1481612242&sign=ee856df94a5e059043747fa242b84761&random=123456
http://app.sewise.com/v1/app/info?token=bSjHgdh43NRbxZ9fOrTtjipynmcIh74fUr8u4Rnd
Response
{"status": 200,
"data": {
"appId": "ic89rf8705ztf6uip7",
"userId": "1",
"appName": "平台应用号",
"appType": "4",
"appStatus": "1",
"creationDate": "2016-12-13 10:22:00",
"modifiedDate": "2016-12-13 10:22:00",
"isDelete": "N"
}
}

1.4 删除应用

接口地址

/v1/app/delete

HTTP Content-Type / 请求方式

application/json
GET/POST

请求参数

参数	必选	类型	说明
RequestBody
appid	是	String	应用appID
time	是	int	时间戳
random	否	int	随机数
sign	是	String	加密值

或

参数	必选	类型	说明
RequestBody
token	是	String	授权码

HTTP 响应状态

200

接口示例

Request
curl -X POST -H "Content-Type:application/json" -d http://app.sewise.com/v1/app/delete?appid=ic89rf8705ztf6uip7&time=1481612242&sign=ee856df94a5e059043747fa242b84761&random=123456
http://app.sewise.com/v1/app/delete?token=5Pl5fnufusOgfDFLBvdar1hOw5pw87kXrRTcFLVQ
Response
{"status": 200,"message": "Delete success"}