科特迪瓦的电话号码发生了什么变化，应该如何存储？
科特迪瓦在 2021 年初把用户号码从八位改为十位，所以在那之前编写的测试数据和校验规则，常常是悄无声息地失败的来源。当前的国内号码为十位数字，手机号以 01、05 或 07 开头。
容易让工程师栽跟头的细节是：开头的零不是冠码。它是用户号码的一部分，在国际格式中依然保留，所以科特迪瓦手机号在 E.164 中形如 +225 07 xx xx xx xx。
- 保存完整的字符串，即
+225加全部十位数字，只在显示时添加空格。 - 关闭任何会对 +225 输入去掉前导零的通用规则；它会产生一个任何网络都无法路由的九位值。
- 把八位输入视为旧格式，请用户重新输入，而不要猜测缺失的前缀。
- 保持你的电话号码库更新，因为西非的编号方案元数据会不时变化。
产品和 QA 团队为什么要用 +225 号码做测试？
阿比让是法语西非的商业中心，因此当公司向该地区的法语区扩张时，科特迪瓦常常是第一站。把 +225 测试号码纳入计划的典型原因：
- 市场上线：在营销启动之前，确认注册、登录和找回流程使用本地号码能端到端正常工作。
- 本地化 QA：法语是官方语言，所以全球应用的验证短信常以法语送达，如果账户区域设置如此，也可能是英语。请解析数字，而不是匹配固定短语。
- 钱包与支付引导：移动支付被广泛使用，许多金融产品把手机号视为客户的主要身份。金融科技开通指南介绍了这种模式。
- 区域运营：支持邻近市场（例如塞内加尔）的团队，常在同一套测试中运行科特迪瓦的检查。
哪些服务可以向科特迪瓦号码发送验证码？
科特迪瓦的实时目录列出超过 800 项服务。当前快照中常用的线路包括 WhatsApp、Telegram、Google（Gmail 和 YouTube）、Facebook、Instagram、TikTok、X（Twitter）、ChatGPT (OpenAI)、Microsoft & Outlook、LinkedIn、Uber、Signal 和 Viber。
库存全天都在变化，所以请把任何列表当作起点，并向 API 查询此刻可订购的内容。同一组合的价格也可能因服务而异，这就是它采用实时报价，而不是印成表格的原因。
科特迪瓦 OTP API 的实际流程是怎样的？
让你的 HTTP 客户端指向 https://otproute.com/api/v1，并使用开发者控制台中的 or_live_ Bearer 密钥认证；科特迪瓦订单的国家 id 是 ci。
测试通常从 GET /api/v1/balance 开始，这样余额耗尽的钱包会让任务一开始就失败。接着，GET /api/v1/prices?country=ci&service=<id> 确认当前价格以及该组合是否有库存。订单本身是 POST /api/v1/activations，请求体形如 {"service": "whatsapp", "country": "ci"}；响应包含激活 id 和要输入你自己应用的 +225 号码。
接下来你可以轮询 GET /api/v1/activations/{id}，或者（对并行测试套件更好）让 webhook 订阅 activation.sms_received、activation.expired 和 activation.cancelled。每次推送都在 X-OTPRoute-Signature 头（t=<unix>,v1=<hex>）中签名：请用端点密钥对 <t>.<raw body> 重新计算 HMAC-SHA256，以常量时间比较，并丢弃过期的时间戳。HMAC 详解和 API 文档有更深入的介绍。限制是每个账户每分钟 300 次请求，对短信验证 API 的测试框架来说绰绰有余。
不会写代码的人可以订购 +225 号码吗？
可以。运营人员和代理机构往往更喜欢控制台，它遵循与 API 相同的 OTP 路由规则。
- 在注册页面用你的邮箱和 6 位验证码，或使用 Google，创建账户。
- 为美元钱包充值。
- 选择科特迪瓦，再选择你要验证的服务；确认前会显示价格。
- 把号码复制到应用的手机号字段，并请求验证码。
- 短信一旦收到，就会显示在激活卡片上。
激活保持 20 分钟有效。如果什么都没有收到，或者你先取消，全部金额会自动退回钱包。
科特迪瓦的验证码没有到达时，应该怎么尝试？
验证码缺失通常有普通的原因，所以在上报之前，请先逐项排查：
- 有些服务会针对特定国家或账户类型拒绝虚拟号码；退款正是为这种情况设立的。
- 让 20 分钟的窗口走完，而不是一分钟后就取消，因为有些发送方会让消息排队。
- 稍后再试，或者如果你的测试允许，用同一服务换另一条国家线路。
- 不要每隔几秒就循环下单；拉开重试间隔能让你的钱包和线路都保持健康。
请始终遵守各服务的条款；OTP Route 的《可接受使用政策》适用于每一笔订单。
有长期使用的科特迪瓦号码吗？如何计费？
科特迪瓦没有自助开通的长期号码。专属号码是面向美国和加拿大的产品，每月 $1.95 起；如果你的团队需要长期使用的科特迪瓦号码，请发邮件至 [email protected] 咨询，但需了解能否提供取决于当地规定，也可能无法实现。
计费按使用量付费，来自一个预付的美元钱包，没有月费，也无需选择套餐。科特迪瓦的测试预算可以用银行卡或 USDT/USDC 充值，每次存入之后的 PDF 发票会发送到账户所有者的收件箱。进行集成开发时，可按需把开发账户切换到沙盒，这样完整流程返回的是模拟的号码和验证码，不会动用钱包资金。当前价格见定价页面。
常见问题
没有当地 SIM 卡，也能测试我的应用的科特迪瓦注册流程吗？
可以。从 OTP Gateway 为你要测试的服务订购一个 +225 号码，填入你的注册表单，然后在控制台或通过 API 读取验证码。
保存号码时应该去掉 +225 之后的零吗？
不要。自 2021 年的变更起，开头的零是十位科特迪瓦号码的一部分，在 E.164 存储中必须保留。
OTP Route API 中科特迪瓦的国家 id 是什么？
是 ci。调用 POST /api/v1/activations 或查询价格时，把它用在 country 字段中。
如果科特迪瓦的验证码始终没来，我会被收费吗？
不会。只有验证码送达时才收费；过期或取消的激活会全额退回你的钱包。
验证短信会使用哪种语言？
由发送服务决定，不过科特迪瓦账户最常见的是法语和英语，所以请提取数字验证码，而不要匹配文字。
我能为以后的登录保留同一个 +225 号码吗？
无法作为自助产品提供，因为每个 OTP Gateway 号码只对应一条验证码。长期专属号码只在美国和加拿大即时提供；科特迪瓦可以发邮件给支持团队咨询。
开发集成时如何避免花费钱包资金？
请申请为开发账户启用沙盒模式。它返回模拟的号码和验证码，让你端到端地测试 webhook 和轮询。
服务名称均为其各自所有者的商标，OTP Route 与其无任何关联。请合法使用号码，并遵守各服务的条款及我们的可接受使用政策。