模板同步

​

一、接口信息

​

1. 请求方式：

curl -X POST 'https://api.ycloud.com/v2/whatsapp/templates/{wabaId}/sync' \
-H 'X-API-Key: {{YOUR-API-KEY}}'

​

2. 请求参数：

​

路径参数

​

请求头参数

​

3. 响应参数

​

成功响应（200 OK）

{
  "wabaId": "string",
  "message": "string"
}

{
  "wabaId": "123456789012345",
  "message": "Template sync has been triggered. It may take a few minutes to complete. If templates were recently migrated to this WABA on Meta, the system will automatically retry for up to 30 minutes."
}

​

二、接口说明：

​

1. 权限验证

• 本接口仅限技术开发伙伴使用
• 仅限已绑定至YCloud的WABA使用

​

2. 频率限制

​

WABA 限制

• 时间窗口：10 分钟
• 限制规则：每个WABA在时间窗口内只能触发一次同步请求
• 错误提示：“Template sync for this WABA was recently triggered. Please try again later.”

​

租户限制

• 时间窗口：1 小时
• 最大请求数：20次
• 规则限制：每个租户在时间窗口内最多可发起20次同步请求
• 错误提示：“Too many template sync requests from the tenant. Please try again later.”

​

3. 自动重试

• 最大重试次数：3次
• 重试间隔：5分钟 -> 10分钟 -> 15分钟
• 总重试时长：30分钟

​

4. 错误码