API 调用

本文档介绍如何在你的业务系统中调用森课帮 API。

接口规范

请求地址

https://senkebang.cn/v1/{module}/{action}

• module：API 模块名，如 sms、idcard、weather
• action：具体接口名，如 send、verify、query

认证方式

所有请求必须在 Header 中携带认证信息：

Authorization: Bearer {AccessKey}:{Signature}
X-Timestamp: {Unix时间戳}

签名算法（Python 示例）：

import hmac
import hashlib
import time

def make_signature(access_key, secret_key, method, path, body=""):
    timestamp = str(int(time.time()))
    message = f"{method}\n{path}\n{timestamp}\n{body}"
    signature = hmac.new(
        secret_key.encode(),
        message.encode(),
        hashlib.sha256
    ).hexdigest()
    return f"{access_key}:{signature}", timestamp

请求示例

发送短信

curl -X POST https://senkebang.cn/v1/sms/send \
  -H "Authorization: Bearer AK12345678:abc123..." \
  -H "X-Timestamp: 1746700800" \
  -H "Content-Type: application/json" \
  -d '{
    "mobile": "13800138000",
    "template": "login",
    "params": {"code": "123456"},
    "sign": "森课帮科技"
  }'

响应示例：

{
  "code": 0,
  "message": "success",
  "data": {
    "msg_id": "SM2026050800001",
    "fee": 1,
    "status": "sent"
  }
}

身份证实名认证

curl -X POST https://senkebang.cn/v1/idcard/verify \
  -H "Authorization: Bearer AK12345678:abc123..." \
  -H "X-Timestamp: 1746700800" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "张三",
    "idcard": "110101199001011234"
  }'

错误码说明

错误码	说明	处理建议
0	成功	-
10001	参数缺失	检查必填字段
10002	参数格式错误	核对参数格式要求
20001	余额不足	充值后再试
20002	额度包已用完	购买新的额度包
30001	API 未开通	在市场开通后再调用
30002	QPS 超限	降低请求频率
40001	IP 不在白名单	在密钥设置中添加当前 IP
50001	目标服务不可用	稍后重试或联系客服
50002	风控拦截	检查调用行为是否异常

SDK 下载

森课帮提供官方 SDK，简化认证和调用流程：

语言	安装命令	GitHub
Python	pip install senke-sdk	链接
Java	mvn install senke-sdk	链接
Go	go get github.com/senke/go-sdk	链接
Node.js	npm install senke-sdk	链接