通用说明
皮卡宝 API 为开发者提供了虚拟信用卡管理的完整接口。
请求地址
所有 API 请求的基础 URL：
认证方式
所有 API 请求都需要进行签名验证，详见签名规则部分。
签名规则
为确保API请求的安全性，所有请求都需要进行签名验证。
签名步骤
参数排序
将集合 M 内所有非空参数值按照参数名 ASCII 码从小到大排序（字典序）
构建字符串
使用 URL 键值对格式（key1=value1&key2=value2…）拼接，需要对参数值进行 URL encode
处理特殊字符
若 URL encode 后出现 ’+’ 字符，需要将 ’+’ 替换为 ‘%20’，得到字符串 stringA
生成签名
在 stringA 最后拼接 &key={secretKey}，得到 stringSignTemp对 stringSignTemp 进行 MD5 运算，将结果转换为大写，得到 sign 值
secretKey 由平台提供，请联系客服人员获取
签名示例
// 示例参数
const params = {
appid: "user123",
timestamp: "1640995200000",
amount: "100.00"
};
// 1. 排序并构建字符串
const stringA = "amount=100.00×tamp=1640995200000&appid=user123";
// 2. 拼接密钥
const stringSignTemp = stringA + "&key=YOUR_SECRET_KEY";
// 3. MD5 并转大写
const sign = md5(stringSignTemp).toUpperCase();
响应代码
API 响应采用统一的格式，包含以下字段：
| 字段 | 类型 | 说明 |
|---|
| code | Integer | 响应代码，0 表示成功 |
| msg | String | 响应消息 |
| content | Object/Array | 响应数据内容 |
常见错误代码
响应示例
成功响应:
{
"code": 0,
"msg": "成功",
"content": {
// 数据内容
}
}
{
"code": 40002,
"msg": "参数错误"
}
通用参数
大多数 API 接口都需要以下通用参数：
| 参数名 | 必选 | 类型 | 说明 |
|---|
| appid | √ | string | 用户标识 |
| timestamp | √ | string | 当前时间戳（毫秒），与平台服务器时间不可相差超过 5 分钟 |
| sign | √ | string | 签名值 |
时间戳与服务器时间相差超过 5 分钟的请求将被拒绝
开始使用
现在您已经了解了 API 的基本概念，可以开始使用以下接口：
