API文档

欢迎使用核玄科技API！我们的API基于REST架构设计，使用JSON格式进行数据交换， 支持标准的HTTP方法，为开发者提供简单、可靠的接口服务。

基础信息

  • API基础URL： https://api.xuancore.com/v1
  • 数据格式： JSON
  • 字符编码： UTF-8
  • HTTPS： 必须使用HTTPS

身份认证

所有API请求都需要进行身份认证。我们使用API Key进行认证，请在请求头中包含您的API密钥。

请求头示例 
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

⚠️ 安全提醒

请妥善保管您的API密钥，不要在客户端代码中暴露密钥。建议在服务器端调用API。

获取商户列表

获取当前账户下的所有商户信息列表。

GET /merchants

请求参数

参数名 类型 必填 说明
page integer 否 页码，默认为1
limit integer 否 每页数量，默认为20，最大100
status string 否 商户状态：active, inactive, pending

响应示例

200 OK 
{
  "code": 200,
  "message": "success",
  "data": {
    "merchants": [
      {
        "id": "merchant_123456",
        "name": "示例商户",
        "status": "active",
        "created_at": "2026-03-13T10:00:00Z",
        "updated_at": "2026-03-13T10:00:00Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 1,
      "pages": 1
    }
  }
}