> ## Documentation Index
> Fetch the complete documentation index at: https://developer.speedpay.hk/llms.txt
> Use this file to discover all available pages before exploring further.

# 请求概览

> Open API 的请求地址、请求方法、数据格式与通用响应。

## 请求协议

| 项目   | 说明                                             |
| ---- | ---------------------------------------------- |
| 协议   | HTTPS                                          |
| 请求方法 | `POST`                                         |
| 请求格式 | `application/json`                             |
| 字符编码 | `UTF-8`                                        |
| 时间格式 | `YYYY-MM-DD HH:mm:ss`，示例：`2026-07-24 12:00:00` |

## 环境地址

| 环境   | 地址                         |
| ---- | -------------------------- |
| 测试环境 | `https://test.speedpay.hk` |
| 生产环境 | `https://speedpay.hk`      |

测试环境 host 为 `test.speedpay.hk`，生产环境 host 为 `speedpay.hk`。拼接接口地址时，在对应环境 host 后追加接口路径，例如：

```text theme={null}
https://test.speedpay.hk/mc-platformapi/v1/open/et/vs/card/info/query
```

## 通用 Header

| Header          | 必填 | 说明                                                  |
| --------------- | -- | --------------------------------------------------- |
| `Content-Type`  | 是  | 固定为 `application/json`                              |
| `Authorization` | 是  | 完整 JSON 请求体经 `SHA256withRSA` 签名后再 `BASE64` 编码得到的签名值 |

## 通用请求字段

业务接口通常包含应用 ID、时间戳和业务参数。平台通过 `app_id` 定位商户 API 配置，并结合 `Authorization` 验证请求体签名。具体字段以单个接口文档为准。

| 字段          | 类型      | 必填 | 说明                |
| ----------- | ------- | -- | ----------------- |
| `app_id`    | string  | 是  | 应用 ID，在商户平台生成     |
| `timestamp` | integer | 是  | Unix 秒级时间戳，参与请求验签 |

## 通用响应结构

```json theme={null}
{
  "code": 0,
  "msg": "success",
  "data": {}
}
```

| 字段     | 类型     | 说明             |
| ------ | ------ | -------------- |
| `code` | int    | 业务状态码，`0` 表示成功 |
| `msg`  | string | 返回信息           |
| `data` | object | 业务数据，失败时可能为空   |