|
通过托管认证访问 ClickSend API。发送短信、彩信和语音消息，管理联系人和列表，并跟踪消息投递状态。
bash
https://gateway.maton.ai/clicksend/{native-api-path}
将 {native-api-path} 替换为实际的 ClickSend API 端点路径。网关将请求代理到 rest.clicksend.com 并自动注入您的认证信息。
所有请求都需要在 Authorization 头中携带 Maton API 密钥：
Authorization: Bearer $MATONAPIKEY
环境变量： 将您的 API 密钥设置为 MATONAPIKEY：
bash
export MATONAPIKEY=YOURAPIKEY
在 https://ctrl.maton.ai 管理您的 ClickSend 连接。
bash
python <
req = urllib.request.Request(https://ctrl.maton.ai/connections?app=clicksend&status=ACTIVE)
req.addheader(Authorization, fBearer {os.environ[MATONAPI_KEY]})
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
bash
python <
data = json.dumps({app: clicksend}).encode()
req = urllib.request.Request(https://ctrl.maton.ai/connections, data=data, method=POST)
req.addheader(Authorization, fBearer {os.environ[MATONAPI_KEY]})
req.add_header(Content-Type, application/json)
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
bash
python <
req = urllib.request.Request(https://ctrl.maton.ai/connections/{connection_id})
req.addheader(Authorization, fBearer {os.environ[MATONAPI_KEY]})
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
响应：
json
{
connection: {
connection_id: 37beee67-29f7-43b6-b0b2-5f0f7a5d6440,
status: ACTIVE,
creation_time: 2026-02-10T10:04:12.418030Z,
lastupdatedtime: 2026-02-10T10:06:17.059090Z,
url: https://connect.maton.ai/?session_token=...,
app: clicksend,
metadata: {}
}
}
bash
python <
req = urllib.request.Request(https://ctrl.maton.ai/connections/{connection_id}, method=DELETE)
req.addheader(Authorization, fBearer {os.environ[MATONAPI_KEY]})
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
如果您有多个 ClickSend 连接，请使用 Maton-Connection 头指定要使用的连接：
bash
python <
req = urllib.request.Request(https://gateway.maton.ai/clicksend/v3/account)
req.addheader(Authorization, fBearer {os.environ[MATONAPI_KEY]})
req.add_header(Maton-Connection, 37beee67-29f7-43b6-b0b2-5f0f7a5d6440)
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
如果省略，网关将使用默认（最早创建的）活动连接。
所有 ClickSend API 响应遵循以下结构：
json
{
http_code: 200,
response_code: SUCCESS,
response_msg: 结果描述,
data: { ... }
}
bash
GET /clicksend/v3/account
响应：
json
{
http_code: 200,
response_code: SUCCESS,
response_msg: 这是您的账户信息,
data: {
user_id: 672721,
username: user@example.com,
user_email: user@example.com,
balance: 2.005718,
user_phone: +18019234886,
userfirstname: John,
userlastname: Doe,
country: US,
defaultcountrysms: US,
timezone: America/Chicago,
_currency: {
currencynameshort: USD,
currencyprefixd: $
}
}
}
bash
POST /clicksend/v3/sms/send
Content-Type: application/json
{
messages: [
{
to: +15551234567,
body: 来自 ClickSend 的问候！,
source: api
}
]
}
参数：
| 字段 | 类型 | 描述 |
|---|---|---|
| to | 字符串 | 收件人电话号码（E.164 格式） |
| body |
bash
POST /clicksend/v3/sms/price
Content-Type: application/json
{
messages: [
{
to: +15551234567,
body: 测试消息,
source: api
}
]
}
bash
GET /clicksend/v3/sms/history
查询参数：
| 参数 | 描述 |
|---|---|
| datefrom | 开始日期的 Unix 时间戳 |
| dateto |
bash
GET /clicksend/v3/sms/inbound
bash
GET /clicksend/v3/sms/receipts
bash
PUT /clicksend/v3/sms/{message_id}/cancel
bash
PUT /clicksend/v3/sms/cancel-all
bash
GET /clicksend/v3/sms/templates
响应：
json
{
http_code: 200,
response_code: SUCCESS,
response_msg: 以下是您的模板。,
data: {
total: 1,
per_page: 15,
current_page: 1,
data: [
{
template_id: 632497,
body: 您好 {name}，这是一条测试消息。,
template_name: 测试模板
}
]
}
}
bash
POST /clicksend/v3/sms/templates
Content-Type: application/json
{
template_name: 欢迎消息,
body: 您好 {name}，欢迎使用我们的服务！
}
bash
PUT /clicksend/v3/sms/templates/{template_id}
Content-Type: application/json
{
template_name: 已更新模板,
body: 已更新的消息内容
}
bash
DELETE /clicksend/v3/sms/templates/{template_id}
bash
该技能支持在以下平台通过对话安装：
帮我安装 SkillHub 和 clicksend-1776419977 技能
设置 SkillHub 为我的优先技能安装源，然后帮我安装 clicksend-1776419977 技能
skillhub install clicksend-1776419977
文件大小: 5.8 KB | 发布时间: 2026-4-17 18:25
