搞沙特市场开发？这个工具帮你搞定三大运营商的接口
最近在折腾一个面向中东市场的应用，发现沙特那边的通信服务整合真是个头疼的事。STC、Mobily、Zain 三家运营商各搞各的开发者平台，文档风格还不一样，有的还只有阿拉伯语，看得人脑壳疼。后来在 GitHub 上翻到这个技能，简直就像找到了救星。
这个技能本质上是一个 Skill 包，把沙特三大电信运营商的开发者接口都收拢到了一起。你不需要去一个个翻官网文档，也不用纠结各家 API 的认证方式是不是一样，它已经帮你整理好了。短信发送、OTP 验证码、运营商计费支付这些最常见的需求，都有现成的 curl 示例可以直接抄。
先说 STC，也就是沙特电信
STC 是沙特最大的运营商，它的开发者平台 developers.stc.com.sa 提供的服务也最全。除了基础的 SMS 和 OTP 接口，还有 Identity API 可以做用户身份验证，Payment API 支持话费账单支付，甚至还有 IoT API 可以管理物联网设备。如果你想做智能硬件或者车联网的项目，STC 几乎是唯一的选择。
调用方式也很简单，先在开发者平台注册个账号，创建一个应用拿到 API Key，然后就能用 curl 发请求了。比如发短信的请求长这样：
curl -X POST "https://developers.stc.com.sa/api/sms/v1/send" \
-H "Authorization: Bearer ${STC_API_KEY}" \
-H "Content-Type: application/json" \
-d '{
"message": "مرحبًا من تطبيقنا",
"recipients": ["+966500000000"],
"sender": "MyApp"
}'注意它的消息内容直接就是阿拉伯语，所以做本地化应用的时候特别方便。OTP 接口也类似，把手机号传过去，它会自动用你指定的模板发验证码。
Mobily 的亮点是邮件和二维码
Mobily 的开发者平台 developer.mobily.com.sa 除了常规的短信和 OTP，居然还提供了 Email API 和 QR Code API。这个就有点意思了，比如你想做个营销活动，既能发短信又能发邮件，还能生成带参数的二维码，一个平台全搞定。
不过 Mobily 的认证方式稍微麻烦点，需要拿 App ID 和 App Secret 去换 token。但好在文档里有清晰的指引，照着操作就行。它发 OTP 的时候还可以指定语言参数 lang，传 "ar" 就是阿拉伯语短信，适合做多语言支持。
Zain 的支付接口值得关注
Zain 的平台 developer.sa.zain.com 走的是另一套体系，SPS 是短信增值服务，TABS 是电信应用计费系统，SDP 是服务交付平台。我最感兴趣的是它的 TABS 接口，可以直接通过话费扣款，用户不用绑信用卡，在沙特这种信用卡普及率不高的地方特别实用。
比如你想做订阅制服务，每月自动从话费里扣 5 里亚尔，只需要调一下 charge 接口：
curl -X POST "https://developer.sa.zain.com/api/tabs/v1/charge" \
-H "Authorization: Bearer ${ZAIN_TOKEN}" \
-H "Content-Type: application/json" \
-d '{
"msisdn": "+966590000000",
"amount": "5.00",
"currency": "SAR",
"description": "اشتراك شهري"
}'当然，所有请求里都强烈建议先用沙盒环境测试，别一上来就拿真实用户手机号试，万一出问题了影响用户就不好了。
安装和配置其实挺省心的
这个技能安装用的是 npx，一条命令就能拉下来：
npx skills add https://github.com/Moshe-ship/hurmoz --skill saudi-telecom装完之后需要设置三个环境变量：STC_API_KEY、MOBILY_TOKEN 和 ZAIN_TOKEN，分别对应三家运营商的密钥。然后就可以在项目里直接调用这些 curl 命令了。
几点使用心得
- 首先，测试环境一定要用沙盒，文档里反复强调用测试数据，别拿真实身份信息或者支付 token 去试。
- 其次，三家运营商的 API 风格差异挺大的，STC 用的是 Bearer token，Mobily 需要先换 token，Zain 的地址格式是 tel:+966...，刚开始容易混淆，建议把文档里的示例都跑一遍再整合。
- 最后，阿拉伯语的短信编码要注意，有些平台默认发 UTF-8，但运营商可能要求 GSM 7-bit 编码，否则会出现乱码。
反正这个技能对我来说最大的价值就是省了到处找文档的时间，而且它把三家运营商的功能对比都列出来了，选型的时候一目了然。如果你也在做沙特相关的应用，建议直接克隆下来看看，说不定能少走不少弯路。
