Skip to main content

​
通用说明

皮卡宝 API 为开发者提供了虚拟信用卡管理的完整接口。

​
请求地址

所有 API 请求的基础 URL： 
https://kf.pikabao.cc

​
认证方式

所有 API 请求都需要进行签名验证，详见签名规则部分。

​
签名规则

为确保API请求的安全性，所有请求都需要进行签名验证。

​
签名步骤

1

参数排序

将集合 M 内所有非空参数值按照参数名 ASCII 码从小到大排序（字典序）
2

构建字符串

使用 URL 键值对格式（key1=value1&key2=value2…）拼接，需要对参数值进行 URL encode
3

处理特殊字符

若 URL encode 后出现 ’+’ 字符，需要将 ’+’ 替换为 ‘%20’，得到字符串 stringA
4

生成签名

在 stringA 最后拼接 &key={secretKey}，得到 stringSignTemp对 stringSignTemp 进行 MD5 运算，将结果转换为大写，得到 sign 值
secretKey 由平台提供，请联系客服人员获取

​
签名示例

// 示例参数
const params = {
  appid: "user123",
  timestamp: "1640995200000",
  amount: "100.00"
};

// 1. 排序并构建字符串
const stringA = "amount=100.00&timestamp=1640995200000&appid=user123";

// 2. 拼接密钥
const stringSignTemp = stringA + "&key=YOUR_SECRET_KEY";

// 3. MD5 并转大写
const sign = md5(stringSignTemp).toUpperCase();

​
响应代码

API 响应采用统一的格式，包含以下字段：
字段类型说明
codeInteger响应代码，0 表示成功
msgString响应消息
contentObject/Array响应数据内容

​
常见错误代码

​
40002
参数错误
请求参数不正确或缺少必需参数
​
10006
对象不存在
请求的资源不存在
​
20001
余额不足
账户余额不足以完成操作
​
40005
签名错误
签名验证失败，请检查签名算法和密钥

​
响应示例

成功响应: 
{
  "code": 0,
  "msg": "成功",
  "content": {
    // 数据内容
  }
}
错误响应: 
{
  "code": 40002,
  "msg": "参数错误"
}

​
通用参数

大多数 API 接口都需要以下通用参数：
参数名必选类型说明
appid√string用户标识
timestamp√string当前时间戳（毫秒），与平台服务器时间不可相差超过 5 分钟
sign√string签名值
时间戳与服务器时间相差超过 5 分钟的请求将被拒绝

​
开始使用

现在您已经了解了 API 的基本概念，可以开始使用以下接口：

用户信息

获取用户账户信息和余额

信用卡管理

查看和管理虚拟信用卡

开卡服务

创建新的虚拟信用卡

交易查询

查询信用卡交易记录