API请求文档参考
1 生成token的过程
token是在所有接口访问中都必须传递的加密参数,以此保证接口安全性,所以token是需要实时生成的。
需要条件
- 密钥:由内部提供
- 方法名
- 生成token的过程
- md5('$function xxxxxx.xxxx.$secret_key)
- Token生成规则
- 拼接字符串
- 后对拼接好的字符串进行MD5(32位)加密后得到的32位字符串就是对应接口的token。
例:加密后得到的32位字符串就是对应方法名为 test 的接口token。
2. API 名称
getFXOrder
3. 请求方式
POST
4. 请求类型
'Content-Type': 'application/x-www-form-urlencoded'
5. 请求URL
https://www.xiwenleji.cn/
6. 请求参数
参数名称 | 类型 | 是否必填 | 描述 |
---|---|---|---|
date | date | 是 | 日期,格式为 YYYY-MM-DD |
token | string | 是 | 用户的唯一标识符 |
7. 请求示例
code
POST /api/createToken
Content-Type: application/x-www-form-urlencoded
token=xxx&adate=xxxx-xx-xx
8. 响应参数
参数名称 | 类型 | 描述 |
---|---|---|
error_code | int | 请求状态,如 0 为 success 为 其余字母均为 error |
msg | string | 返回的提示信息 |
data | object | 返回的订单数据 |
9. 响应示例
json
{
"error_code": 0,
"msg": "success",
"count": 1,
"data": [
{
"id": 3
}
]
}
10. 错误码
错误码 | 描述 |
---|---|
0 | 成功 |
301 | 日期格式错误 |
305 | 日期为必传参数! |
400 | token不能为空 |
403 | token不正确 |
500 | 服务器内部错误 |
11. 注意事项
- 请确保所有必填参数都已提供。
- 日期格式必须为
YYYY-MM-DD
。 - 如果请求失败,请根据错误码和返回信息进行排查。
- token有效期为xxx,过期验证失效,如失效,请重新生成