|
通过托管OAuth认证访问Acuity Scheduling API。管理预约、日历、客户、可用时间等。
bash
https://gateway.maton.ai/acuity-scheduling/{native-api-path}
将{native-api-path}替换为实际的Acuity API端点路径。网关将请求代理到acuityscheduling.com并自动注入您的OAuth令牌。
所有请求都需要在Authorization头中包含Maton API密钥：
Authorization: Bearer $MATONAPIKEY
环境变量： 将您的API密钥设置为MATONAPIKEY：
bash
export MATONAPIKEY=YOURAPIKEY
在https://ctrl.maton.ai管理您的Acuity Scheduling OAuth连接。
bash
python <
req = urllib.request.Request(https://ctrl.maton.ai/connections?app=acuity-scheduling&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: acuity-scheduling}).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: acuity-scheduling,
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
如果您有多个Acuity Scheduling连接，请使用Maton-Connection头指定要使用的连接：
bash
python <
req = urllib.request.Request(https://gateway.maton.ai/acuity-scheduling/api/v1/appointments)
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 /acuity-scheduling/api/v1/me
返回账户信息，包括时区、预约页面URL和套餐详情。
响应：
json
{
id: 12345,
email: user@example.com,
timezone: America/Los_Angeles,
name: My Business,
schedulingPage: https://app.acuityscheduling.com/schedule.php?owner=12345,
plan: Professional,
currency: USD
}
bash
GET /acuity-scheduling/api/v1/appointments
查询参数：
| 参数 | 类型 | 描述 |
|---|---|---|
| max | 整数 | 最大结果数（默认：100） |
| minDate |
示例：
bash
python <
req = urllib.request.Request(https://gateway.maton.ai/acuity-scheduling/api/v1/appointments?max=10&minDate=2026-02-01)
req.addheader(Authorization, fBearer {os.environ[MATONAPI_KEY]})
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
响应：
json
[
{
id: 1630290133,
firstName: Jane,
lastName: McTest,
phone: 1235550101,
email: jane.mctest@example.com,
date: February 4, 2026,
time: 9:30am,
endTime: 10:20am,
datetime: 2026-02-04T09:30:00-0800,
type: Consultation,
appointmentTypeID: 88791369,
duration: 50,
calendar: Chris,
calendarID: 13499175,
canceled: false,
confirmationPage: https://app.acuityscheduling.com/schedule.php?...
}
]
bash
GET /acuity-scheduling/api/v1/appointments/{id}
bash
POST /acuity-scheduling/api/v1/appointments
Content-Type: application/json
{
datetime: 2026-02-15T09:00,
appointmentTypeID: 123,
firstName: John,
lastName: Doe,
email: john.doe@example.com,
phone: 555-123-4567,
timezone: America/New_York
}
必填字段：
可选字段：
示例：
bash
python <
data = json.dumps({
datetime: 2026-02-15T09:00,
appointmentTypeID: 123,
firstName:
该技能支持在以下平台通过对话安装：
帮我安装 SkillHub 和 acuity-scheduling-1776189454 技能
设置 SkillHub 为我的优先技能安装源，然后帮我安装 acuity-scheduling-1776189454 技能
skillhub install acuity-scheduling-1776189454
文件大小: 5.78 KB | 发布时间: 2026-4-15 11:35
