使用额度卡管理接口可以进行查询额度卡列表、查询额度卡信息、转让额度卡额度、销毁额度卡。

查询额度卡列表

适用对象： 第三方服务端请求

请求URL： https://api.espai.fun/cdkey/list

请求方式： POST

请求参数：

字段名	类型	必填	描述
id	string	否	额度卡ID； 例如：772868ead56c48d68fd1924aa5ec3aac
type	string	否	额度卡类型；1：付费额度卡(青龙)，2：付费额度卡(九尾狐)， 3：付费额度卡(玄武)，4：付费额度卡(烛龙)，5：付费额度卡(饕餮)
code	string	否	兑换码
username	string	否	用户昵称
user_phone	string	否	用户手机号
api_limit	string	否	剩余调用额度
page	string	否	分页查询当前页；默认当前第1页
limit	string	否	分页查询查询条数；默认查询9999条

注意：当所有参数都不传时，默认查询当前用户下的所有额度卡，返回额度卡列表。

参数示例：

{
  "id": "772868ead56c48d68fd1924aa5ec3aac",
  "type": "0",
  "code": "wNaa1GDw",
  "user_name": "琳琅",
  "user_phone": "15916888888",
  "api_limit": "423",
  "page": "1",
  "limit": "10"
}

返回参数：

字段名	类型	必填	描述
success	boolean	是	结果标识；true：成功，false：请求失败
totalNumber	number	是	返回的数据总数
message	string	是	返回的消息；例如：请求成功或其他异常信息
data	array	是	返回的数据列表

返回示例：

{
  "message": "请求成功",
  "data": [
    {
      "id": "772868ead56c48d68fd1924aa5ec3aac",
      "create_time": 1743506056109,
      "update_time": null,
      "code": "wNaa1GDw",
      "user_id": "87215a4192654cea8781a1a596d23cae",
      "api_limit": 500,
      "type": "0",
      "user_phone": 15916888888,
      "user_name": "琳琅"
    }
  ],
  "totalNumber": 1,
  "success": true
}

错误示例：

{
  "success": false,
  "message": "系统错误：xxx",
  "code": 500
}

代码示例：

Nodejs

const axios = require('axios');

// 定义请求头部
const headers = {
    'authorization': 'esp_ai平台的32位open_api_key',
    'Content-Type': 'application/json'
};


// 定义要发送的数据
const data = {
    "id": "772868ead56c48d68fd1924aa5ec3aac",
    "type": "0",
    "code": "wNaa1GDw",
    "user_name": "琳琅",
    "user_phone": "15916888888",
    "api_limit": "423",
    "page": "1",
    "limit": "10",
};

// 发送POST请求
axios.post('https://api.espai.fun/cdkey/list', data, {headers})
    .then(response => {
        console.log(response.data);
    })
    .catch(error => {
        console.error(error);
    });

查询额度卡信息

适用对象： 第三方服务端请求

请求URL： https://api.espai.fun/cdkey/detail

请求方式： POST

请求参数：

字段名	类型	必填	描述
phone	string	是	用户手机号
code	string	是	兑换码

参数示例：

{
  "code": "wNaa1GDw",
  "phone": "15916888888"
}

返回参数：

字段名	类型	必填	描述
success	boolean	是	结果标识；true：成功，false：请求失败
message	string	是	返回的消息；例如：请求成功或其他异常信息
data	json	是	返回的额度卡数据

返回示例：

{
  "success": true,
  "message": "请求成功",
  "data": {
    "id": "772868ead56c48d68fd1924aa5ec3aac",
    "create_time": 1743506056109,
    "update_time": null,
    "code": "wNaa1GDw",
    "user_id": "87215a4192654cea8781a1a596d23cae",
    "api_limit": 500,
    "type": "0",
    "user_phone": 15916888888,
    "user_name": "琳琅"
  }
}

错误示例：

{
  "success": false,
  "message": "系统错误：xxx",
  "code": 500
}

代码示例：

Nodejs

const axios = require('axios');

// 定义请求头部
const headers = {
    'authorization': 'esp_ai平台的32位open_api_key',
    'Content-Type': 'application/json'
};


// 定义要发送的数据
const data = {
    "code": "wNaa1GDw",
    "phone": "15916888888",
};

// 发送POST请求
axios.post('https://api.espai.fun/cdkey/detail', data, {headers})
    .then(response => {
        console.log(response.data);
    })
    .catch(error => {
        console.error(error);
    });

转让额度卡额度

适用对象： 第三方服务端请求

请求URL： https://api.espai.fun/cdkey/transfer

请求方式： POST

请求参数：

字段名	类型	必填	描述
phone	string	是	当前用户手机号
code	string	是	当前卡的兑换码
target_phone	string	是	目标用户手机号
target_code	string	是	目标卡的兑换码
limit	string	是	转让额度；最小额度1

注意：额度卡余额转让必须都是付费卡，免费体验卡不能进行额度转让操作。

参数示例：

{
  "code": "wNaa1GDw",
  "phone": "15916888888",
  "target_code": "3AoPbLSQ",
  "target_phone": "17516888888",
  "limit": "10"
}

返回参数：

字段名	类型	必填	描述
success	boolean	是	结果标识；true：成功，false：请求失败
message	string	是	返回的消息；例如：请求成功或其他异常信息

返回示例：

{
  "success": true,
  "message": "请求成功"
}

错误示例：

{
  "success": false,
  "message": "系统错误：xxx",
  "code": 500
}

代码示例：

Nodejs

const axios = require('axios');

// 定义请求头部
const headers = {
    'authorization': 'esp_ai平台的32位open_api_key',
    'Content-Type': 'application/json'
};


// 定义要发送的数据
const data = {
    "code": "wNaa1GDw",
    "phone": "15916888888",
    "target_code": "3AoPbLSQ",
    "target_phone": "17516888888",
    "limit": "10"
};

// 发送POST请求
axios.post('https://api.espai.fun/cdkey/transfer', data, {headers})
    .then(response => {
        console.log(response.data);
    })
    .catch(error => {
        console.error(error);
    });

销毁额度卡

适用对象： 第三方服务端请求

请求URL： https://api.espai.fun/cdkey/destroy

请求方式： POST

请求参数：

字段名	类型	必填	描述
id	string	是	额度卡ID

注意：额度卡销毁必须是付费卡并且余额为0才能销毁，否则拒绝操作。

参数示例：

[
  {
    "id": "196bd2a26e4d459f9dc7d12053a05c15"
  }
]

返回参数：

字段名	类型	必填	描述
success	boolean	是	结果标识；true：成功，false：请求失败
message	string	是	返回的消息；例如：删除成功或其他异常信息

返回示例：

{
  "success": true,
  "message": "删除成功"
}

错误示例：

{
  "success": false,
  "message": "系统错误：xxx",
  "code": 500
}

代码示例：

Nodejs

const axios = require('axios');

// 定义请求头部
const headers = {
    'authorization': 'esp_ai平台的32位open_api_key',
    'Content-Type': 'application/json'
};


// 定义要发送的数据
const data = [{"id": "196bd2a26e4d459f9dc7d12053a05c15"}];

// 发送POST请求
axios.post('https://api.espai.fun/cdkey/destroy', data, {headers})
    .then(response => {
        console.log(response.data);
    })
    .catch(error => {
        console.error(error);
    });