用途：在服务端、Worker 或云函数等长驻代码中通过 Sendblue REST API 发送与接收短信类消息，覆盖 iMessage（蓝色气泡）、SMS 和 RCS。纯 JSON over HTTPS，无需 SDK；若只需 shell 场景的一次性发送，可改用 sendblue-cli。
主要能力：一对一发送（文本和/或媒体）、群组消息与命名群线程、iMessage 特效（celebration、fireworks、confetti 等，仅 iMessage）、tapback 回应、正在输入指示、已读回执、媒体上传、送达状态查询、号码 iMessage 可用性检测、消息历史、联系人 CRUD、号码线路列表以及 webhook 订阅管理。
使用方式：所有请求发往 https://api.sendblue.com，需带请求头 sb-api-key-id、sb-api-secret-key 与 Content-Type: application/json。发送示例：curl -X POST https://api.sendblue.com/api/send-message -H "sb-api-key-id: $KEY_ID" -H "sb-api-secret-key: $SECRET" -H 'Content-Type: application/json' -d '{"number":"+15551234567","from_number":"+1YOUR_SENDBLUE_NUMBER","content":"Hello from the API!"}'。号码须为 E.164 格式，from_number 必须是自有线路（GET /api/lines 查询）。同步响应含 message_handle（Apple GUID，用于回应、回复和关联回调）与状态；用 status_callback 跟踪送达，在后台配置 webhook 并用 POST /api/account/webhooks 管理。入站事件类型包括 receive、outbound、typing_indicator、call_log、line_blocked、line_assigned、contact_created。
适用场景：需要比 CLI 更完整能力的服务集成，如特效、群发、回应、状态回调、媒体上传与联系人管理；以及通过 webhook 接收回复的自动化流程。
限制：同步发送响应只表示已接受，不代表已送达；最终状态经 status_callback 或 GET /api/status 获取。send_style 在 SMS 上静默失效，回应与特效仅限 iMessage。入站媒体 URL 约 30 天后过期，需下载并转存。每条线路有速率限制，短时间大量发送可能触发 Apple 垃圾信息判定。API 凭据须仅保留在服务端，不得下发到浏览器或移动端；webhook 应使用 HTTPS 并保证幂等，非 2xx 会触发重试与重复投递。