Taifa Mobile

厂商定位

Taifa Mobile Ltd 是肯尼亚本地 短信网关中间商，提供 SMS 发送能力（REST v2 / Legacy PHP 双版本，另有 SMPP 通道）。当前知识库维护其 v2 短信发送 能力，适合肯尼亚本地通知类短信 / OTP 场景，与 FastHub 同属通信能力域，可作为肯尼亚短信的备选或主用通道。

能力归属

• 通信能力（SMS 发送）

已整理资料

• Taifa 短信发送接口整理：v2 接口全量说明（认证、参数、响应、全量错误码与重试语义、接入待确认项）。

核心能力

能力	接口	说明
发送短信（v2）	POST /v2/sms/sendsms	主接口，多号码逗号分隔，数组响应逐号码一条结果
查询余额	GET /v2/sms/units	预付费 credit_balance
健康检查	GET /v2/sms/health	联通性探测
SMPP 通道	TCP 2775	超高吞吐场景（千级 TPS），凭据独立，需 POST /v2/sms/smpp-credentials 单独注册

关键特性

• 认证极简：API Key（64 位 hex）放 Header h_api_key，无签名、无加解密，明文 JSON over HTTPS。
• HTTP 恒为 200，业务成败完全由响应体 status_code 表达（1000 = 成功），必须解析 body 判断。
• 消息最大 920 字符（6 条 SMS 拼接）；号码支持 07xx / 01xx / 254xxxxxxxxx，建议统一传 254xxxxxxxxx。
• sender_name 必须是账户下已注册的 Sender ID，否则 1001。
• 预付费 credit 模式，余额不足返回 1004，需接余额监控告警。
• v2 与 Legacy 响应结构完全一致，切换仅改 Base URL。

错误码语义速查

类别	status_code	处理
成功	1000	记录 message_id
客户端参数类（不重试）	1001 1002 1003 1009 1010 1012	校验 sender/号码/请求体
账户配置类（不重试，告警）	1004(充值后可重投) 1006 1011 1013 1014	余额/封禁/API Key/IP 白名单
供应商系统类（可重试）	1005 1007 1008	按重试策略重投

完整表见 接口整理 §错误码。

与 FastHub 的边界

维度	Taifa	FastHub
覆盖	肯尼亚（本地中间商）	多国（SMS / WhatsApp / USSD）
渠道	SMS（REST/SMPP）	Bulk SMS、WhatsApp API、USSD
适用	肯尼亚短信主用或冗余通道	需要 WhatsApp / USSD 或跨国触达

接入待确认

• 是否有独立测试环境地址（文档只给了生产 api.taifamobile.co.ke，暂靠不同 API Key 区分）。
• IP 白名单是否必须（错误码 1014 暗示存在该机制，需报出口 IP）。
• Rate Limit / QPS 上限（文档未说明，暂按保守并发）。
• Sender ID 注册流程与审批周期。
• 多号码批量部分失败时的结果回传结构（数组逐号码明细）。