Zapier API参考

QR Code Maker Zapier集成的完整API文档。包含OAuth 2.0认证、所有端点、请求/响应格式和Webhook。

QR Code Maker与Zapier集成的完整API参考文档。本文档涵盖认证、所有端点、请求/响应格式和Webhook事件。

基础URL

https://qr-code-maker.app

认证

API使用OAuth 2.0授权码流程。

OAuth 2.0流程

  1. 授权请求 - 重定向用户进行授权
  2. 授权码 - 用户批准，获得授权码
  3. 令牌交换 - 用授权码换取访问令牌
  4. API请求 - 所有请求使用Bearer令牌
  5. 令牌刷新 - 访问令牌过期时刷新

授权端点

GET /oauth/authorize

参数：

参数类型必填描述
client_idstring是OAuth客户端ID
redirect_uristring是重定向URL
response_typestring是必须为code
statestring是CSRF保护字符串
scopestring否空格分隔的作用域

可用作用域：

作用域描述
qr_codes:read读取QR码
qr_codes:write创建、更新、删除
analytics:read访问统计数据
webhooks:write管理Webhook

令牌交换

POST /api/oauth/token

令牌有效期：

令牌有效期
授权码10分钟
访问令牌1小时
刷新令牌30天

令牌刷新

POST /api/oauth/refresh

API端点

所有请求需要Bearer令牌：

Authorization: Bearer qrc_at_xxxxxxxx

测试连接

GET /api/zapier/me

列出QR码

GET /api/zapier/qr

创建QR码

POST /api/zapier/qr

支持的类型：

类型字段
website{ "url": "https://..." }
vcard{ "firstName": "", "lastName": "", ... }
wifi{ "ssid": "", "password": "", "security": "WPA" }
email{ "email": "", "subject": "", "body": "" }
sms{ "phone": "", "message": "" }
phone{ "phone": "" }
text{ "text": "" }
event{ "title": "", "startDate": "", "endDate": "", "location": "" }

获取QR码

GET /api/zapier/qr/{id}

更新QR码

PATCH /api/zapier/qr/{id}

删除QR码

DELETE /api/zapier/qr/{id}

搜索

GET /api/zapier/qr/search

分析

GET /api/zapier/qr/{id}/analytics

文件夹

GET /api/zapier/folders

Webhook

订阅

POST /api/zapier/webhooks/subscribe

事件：

事件描述
qr.scannedQR码被扫描
qr.createdQR码已创建
qr.milestone.100达到100次扫描
qr.milestone.500达到500次扫描
qr.milestone.1000达到1,000次扫描
qr.milestone.5000达到5,000次扫描
qr.milestone.10000达到10,000次扫描

取消订阅

DELETE /api/zapier/webhooks/{id}

错误处理

HTTP状态码

状态描述
200成功
201已创建
204无内容
400请求错误
401未认证
403禁止访问
404未找到
422验证错误
429超出速率限制
500服务器错误

速率限制

  • 限制： 每个令牌每分钟100个请求

开始使用

  1. 访问我们的Zapier集成
  2. 授权QR Code Maker
  3. 创建您的第一个Zap

支持

有问题？请联系support@qr-code-maker.app。