|
通过托管OAuth认证访问GetResponse API。管理邮件营销活动、联系人、新闻通讯、自动回复器、细分和表单。
bash
https://gateway.maton.ai/getresponse/{native-api-path}
将{native-api-path}替换为实际的GetResponse API端点路径。网关将请求代理到api.getresponse.com并自动注入您的OAuth令牌。
所有请求都需要在Authorization头中包含Maton API密钥：
Authorization: Bearer $MATONAPIKEY
环境变量： 将您的API密钥设置为MATONAPIKEY：
bash
export MATONAPIKEY=YOURAPIKEY
在https://ctrl.maton.ai管理您的GetResponse OAuth连接。
bash
python <
req = urllib.request.Request(https://ctrl.maton.ai/connections?app=getresponse&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: getresponse}).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: 21fd90f9-5935-43cd-b6c8-bde9d915ca80,
status: ACTIVE,
creation_time: 2025-12-08T07:20:53.488460Z,
lastupdatedtime: 2026-01-31T20:03:32.593153Z,
url: https://connect.maton.ai/?session_token=...,
app: getresponse,
metadata: {}
}
}
在浏览器中打开返回的url以完成OAuth授权。
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
如果您有多个GetResponse连接，请使用Maton-Connection头指定要使用的连接：
bash
python <
req = urllib.request.Request(https://gateway.maton.ai/getresponse/v3/campaigns)
req.addheader(Authorization, fBearer {os.environ[MATONAPI_KEY]})
req.add_header(Maton-Connection, 21fd90f9-5935-43cd-b6c8-bde9d915ca80)
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
如果省略，网关将使用默认（最旧）的活动连接。
bash
GET /getresponse/v3/accounts
bash
GET /getresponse/v3/accounts/billing
GetResponse中的营销活动等同于邮件列表/受众。
bash
GET /getresponse/v3/campaigns
带分页：
bash
GET /getresponse/v3/campaigns?page=1&perPage=100
bash
GET /getresponse/v3/campaigns/{campaignId}
bash
POST /getresponse/v3/campaigns
Content-Type: application/json
{
name: 我的营销活动
}
bash
GET /getresponse/v3/contacts
带营销活动筛选：
bash
GET /getresponse/v3/contacts?query[campaignId]={campaignId}
带分页：
bash
GET /getresponse/v3/contacts?page=1&perPage=100
带排序：
bash
GET /getresponse/v3/contacts?sort[createdOn]=desc
bash
GET /getresponse/v3/contacts/{contactId}
bash
POST /getresponse/v3/contacts
Content-Type: application/json
{
email: john@example.com,
name: John Doe,
campaign: {
campaignId: abc123
},
customFieldValues: [
{
customFieldId: xyz789,
value: [自定义值]
}
]
}
bash
POST /getresponse/v3/contacts/{contactId}
Content-Type: application/json
{
name: John Smith,
customFieldValues: [
{
customFieldId: xyz789,
value: [更新后的值]
}
]
}
bash
DELETE /getresponse/v3/contacts/{contactId}
bash
GET /getresponse/v3/contacts/{contactId}/activities
bash
GET /getresponse/v3/custom-fields
bash
GET /getresponse/v3/custom-fields/{customFieldId}
bash
POST /getresponse/v3/custom-fields
Content-Type: application/json
{
name: company,
type: text,
hidden: false,
values: []
}
bash
GET /getresponse/v3/newsletters
bash
POST /getresponse/v3/newsletters
Content-Type: application/json
{
subject: 新闻通讯主题,
name: 内部新闻通讯名称,
campaign: {
campaignId: abc123
},
content: {
html:
bash
POST /getresponse/v3/newsletters/send-draft
Content-Type: application/json
{
messageId: newsletter123,
sendOn: 2026-02-15T10:00:00Z
}
bash
GET /getresponse/v3/rss-newsletters
bash
GET /getresponse/v3/tags
bash
GET /getresponse/v3/tags/{tagId}
bash
POST /getresponse/v3/tags
Content-Type: application/json
{
name: VIP客户
}
bash
POST /getresponse/v3/tags/{tagId}
Content-Type: application/json
{
name: 高级客户
}
bash
DELETE /getresponse/v3/tags/{tagId}
bash
POST /getresponse/v3/contacts/{contactId}/tags
Content-Type: application/json
{
tags: [
{tagId: abc123},
该技能支持在以下平台通过对话安装：
帮我安装 SkillHub 和 getresponse-1776420046 技能
设置 SkillHub 为我的优先技能安装源，然后帮我安装 getresponse-1776420046 技能
skillhub install getresponse-1776420046
文件大小: 5.45 KB | 发布时间: 2026-4-17 18:43
