#### 1. 接口约定
- 以下所有 `POST`、`PUT` 请求,在未另外声明的情况下,统一采用 `Content-Type : application/json`
- 字符编码,统一采用 `UTF-8`
- 参数类型
1. path 参数,简称路径参数,写在url路径上的参数,如:https://api.fpapi.net/v1/{aid}/companies 其中,aid 即为 path 参数
1. query 参数,即 URL 问号(?)后面的参数,多个 query 参数用&拼接。如:https://api.fpapi.net/v1/xxx/companies?page=1 其中,page=1 即为 query 参数
1. body 参数,以键值对的 json 形式传入
#### 2. 请求参数
- 公共请求Header参数
参数名 | 数据类型 | 参数类型 | 必填 | 描述
--- | --- | --- | --- | ---
X-FP-NonceStr | string | header | 必填 | 签名的随机字符串
X-FP-Timestamp | string | header | 必填 | 签名的时间戳
Authorization | string | header | 必填 | 签名信息,参考签名方法,用 "FP-SIGN-HMAC-SHA256 " 拼接签名组成
#### 3. 响应参数
- 公共响应参数
参数名称 | 参数类型 | 是否必填 | 描述
--- | --- | --- | ---
code | Int | 是 | 接口返回码
msg | String | 是 | 接口返回码的描述
data | Object | 是 | 接口返回内容,详见各个接口定义
#### 4. 其他约定
> 所有金额,请以元为单位,保留两位小数,**请去掉千分位分隔符**
> 如:一万二千三百四十五元,请输入:12345.00
<p class="align-center"><a href="https://beian.miit.gov.cn" target="_blank">粤ICP备18096044号</a></p>