核心用法
Yuboto Omni API 技能专为开发与 Yuboto（Octapush）消息平台集成的应用而设计，覆盖 SMS、Viber 等多渠道消息服务。核心工作流包括：识别业务场景（单发短信、批量 CSV 发送、获取送达报告 DLR、查询余额/成本、管理联系人列表与黑名单）→ 通过 api_quick_reference.md 或 find_endpoints.py 脚本定位端点 → 以 swagger_v1.json 为权威依据验证请求/响应模式 → 生成含认证头、重试机制、错误处理的健壮代码。
技能提供 CLI 工具链（balance、cost、send-sms、send-csv、dlr、poll-pending、history 等），支持从快速测试到生产集成的全阶段开发。
显著优点
- 来源分级明确：确立 Swagger > 速查文档 > PDF 提取 > 原始 PDF 的优先级，有效规避文档版本冲突
- 安全优先设计：强制环境变量
OCTAPUSH_API_KEY认证，原生支持 OpenClaw 凭证集中管理，明确禁止硬编码密钥 - 实战工具完备：提供端点搜索脚本、CSV 批量发送、状态轮询等生产级辅助工具
- 多语言中立：生成示例默认语言无关，便于国际化部署
潜在缺点与局限性
- 准入门槛：需主动联系 Yuboto 支持开通 API 权限，无法自助即时开通
- 地域限制：成本估算需指定 ISO-3166-1 alpha-2 国家码，对非希腊市场文档支持可能不足
- Viber 功能：高级 Viber 特性需额外查阅 Swagger，PDF 文档覆盖不全
- 密钥管理风险：
.env文件加载机制存在误载无关密钥的隐患（文档已明确警告）
适合人群
- 需集成企业短信/Viber 通道的后端开发者
- 构建营销自动化、OTP 通知、客服系统的工程团队
- 已有 Yuboto/Octapush 账户的技术实施人员
常规风险
- 凭证泄露：API key 以 Base64 Basic Auth 形式传输，若日志未脱敏可能暴露
- 发送合规：必须使用平台预审核的发送方 ID（Sender ID），否则消息被拒
- 数据敏感：本地运行时日志含手机号、消息预览、DLR 回执，需按 PII 级别保护
- 依赖外部：送达状态依赖运营商回执，存在延迟或丢失可能，需设计幂等重试与超时兜底