3 分钟快速接入

一、鉴权说明

本接口采用签名鉴权机制，所有请求必须携带公共请求头。

二、4 步可完成API调用：

Step 1：获取凭证

登录平台获取：API Key API Secret

Step 2：生成签名（X-Sign）

拼接字符串：
X-Api-Key + Secret + X-Timestamp + X-Nonce

然后进行：
SHA256（小写）

Step 3：组装请求头

Step 4：发起请求

三、接口基础说明

请求方式

项目	说明
请求协议	HTTPS
请求方式	POST
数据格式	JSON
编码	UTF-8
Base URL	https://api.feige.cn

四、公共请求头参数

所有接口 必须携带以下请求头：

参数名	必填	类型	说明
X-Api-Key	✅	String	API Key（区分通知类 / 营销类）
X-Timestamp	✅	Number	UNIX 时间戳（秒），误差 ≤ 60 秒
X-Nonce	✅	String	唯一随机字符串（≤40字符）
X-Sign	✅	String	签名值（SHA256 小写）

五、签名机制详解

4.1 签名算法

X-Sign = SHA256(
  X-Api-Key + Secret + X-Timestamp + X-Nonce
)

注意：

无分隔符

必须按顺序拼接

输出为 小写 16 进制字符串

4.2 示例

参数	值
X-Api-Key	SMS01-00001-88888-abcdef
Secret	AAABBBCCC
X-Timestamp	1579315033
X-Nonce	Abc001899937bd

拼接原始字符串：

SMS01-00001-88888-abcdefAAABBBCCC1579315033Abc001899937bd

生成签名：

b194d23005cdde454e2a129d9d5151e8e4d5bc439673230a46c3ddc611b08495

六、代码示例

Java 示例

Python 示例

七、常见错误 & 排查指南

1. 签名错误

💡

原因：

拼接顺序错误

少字段 / 多空格

使用了大写 SHA256

2. 时间戳无效

💡

报错场景：

超过 60 秒

解决方案：

使用服务器时间

避免客户端时间漂移

3. Nonce 重复

💡

原因：

重复请求使用相同随机数

建议：

使用 UUID / 时间戳 + 随机数

4. API Key 使用错误

💡

注意：

通知类 / 营销类 Key 不能混用

八、安全建议（强烈推荐）

Secret 仅存储在服务端

禁止前端直接调用接口

定期更换 API Key / Secret

对请求来源 IP 做白名单控制（如支持）

九、最佳实践

封装统一签名方法

统一请求拦截器自动加 Header

增加重试机制（网络异常）

记录请求日志（方便排查）

十、技术支持

如接入过程中遇到问题，请联系平台技术支持或查看完整 API 文档。

一、鉴权说明#

二、4 步可完成API调用：#

三、接口基础说明#

请求方式#

四、公共请求头参数#

五、签名机制详解#

4.1 签名算法#

4.2 示例#

六、代码示例#

七、常见错误 & 排查指南#

1. 签名错误#

2. 时间戳无效#

3. Nonce 重复#

4. API Key 使用错误#

八、安全建议（强烈推荐）#

九、最佳实践#

十、技术支持#

一、鉴权说明

二、4 步可完成API调用：

三、接口基础说明

请求方式

四、公共请求头参数

五、签名机制详解

4.1 签名算法

4.2 示例

六、代码示例

七、常见错误 & 排查指南

1. 签名错误

2. 时间戳无效

3. Nonce 重复

4. API Key 使用错误

八、安全建议（强烈推荐）

九、最佳实践

十、技术支持