SMS API

面向全球消息团队的紧凑 API 界面。

Amiq 让集成保持可预测：提交消息、追踪状态、接收回调，并让路由决策可观察。

请求结构

适合高量级流程的可读 payload。

官网代理按照 OneHub 合同接入认证、联系、订阅、通道和内容。消息端点可延续同一服务端模式。

api-intent.yaml

identifier: 邮箱或手机号
site: x-onehub-site
error: code, message, requestId
pagination: limit, offset, hasMore

端点族

实现不会把整套 API 目录变成前台控制面板。

登录使用单一 identifier；注册提交邮箱或手机号以及同意值。

咨询留言携带来源 URL，提交到公开联系端点。

公开通道费率通过本地 Route Handler 加载，包含加载、空、错误和刷新状态。

回调

好的 SMS API 把送达视作状态机，而不是一次是或否。

Accepted

校验参数、创建可追踪请求 ID，并返回应用可保存的状态。

Queued

解析目的地和通道逻辑，同时不向客户端泄露供应商细节。

Delivered

下游证据到达后，将送达报告发送到客户 webhook。

Failed

把错误归入可行动类别，用于重试、支持或合规审查。

开发体验

页面有开发者文档的气质，但不会变成单独文档门户。

HTTP 和 JSON 是默认集成原语，适合可预测的服务端到服务端消息。

请求 ID、错误代码和分页字段会通过 Route Handler 保留下来。

API key 和管理员 token 不进入客户端 bundle，通过环境密钥配置。

Amiq 可以在生产路由开启前，帮助建模 OTP、告警或生命周期流量。