1)请求地址
https://v.1dq.com/api/v9/faceset_create
2)示范URL
https://v.1dq.com/api/v9/faceset_create?key=您的key&faceset_name=testface&tag=
3)请求参数
| 字段名称 |
类型 |
必填 |
字段说明 |
示范 |
备注 |
| key |
string |
Y |
AppKey在我的数据页面 |
xxxxxx |
- |
| faceset_name |
string |
Y |
组的名称,必须全局唯一。Name不能包含^@,&=*'"等非法字符，且长度不得超过255 |
testface |
- |
| tag |
string |
N |
标识符,用户可自定义,不能包含^@,&=*'"等非法字符，长度不能超过255 |
|
- |
4)选填参数
| 字段名称 |
类型 |
必填 |
字段说明 |
示范 |
备注 |
| trans_id |
string |
N |
用户订单号,24 字符以内 |
2017201230 |
- |
| trans_date |
string |
N |
用户订单时间,格式为YYmmddHHiiss |
20160112122233 |
- |
| trans_remark |
string |
N |
用户备注,原路返回 |
xxx |
- |
| account |
string |
N |
是否返回账户信息,如需返回剩余可用次数,请传递auto如果账户是按次数扣除,则返回剩余次数如账户是按金额扣除,则返回账户剩余金额
|
auto |
- |
| output |
string |
N |
输出格式,默认JSON;可选项JSON/XML |
JSON |
- |
5)返回参数
| 字段名称 |
类型 |
必填 |
字段说明 |
示范 |
备注 |
| error_code |
int |
Y |
状态码 |
- |
- |
| reason |
string |
Y |
状态说明 |
- |
- |
| ordersign |
string |
Y |
订单号 |
- |
- |
| result |
string |
Y |
结果集 |
- |
- |
| ----faceset_name |
string |
- |
组的名称,全局唯一 |
- |
- |
6)返回JSON结果示例
{
"error_code": 0,
"reason": "请求成功",
"result": {
"faceset_name": "w01",
"tag": "w01"
},
"ordersign": "f345b8fc23453dda559df2d362821b3e"
}
