全球短信API接入完全指南：快速对接短信群发服务

为什么选择API接入？

API接入方式允许您将短信发送功能直接集成到您的业务系统、APP或网站中，实现自动化短信触发。无需手动操作，系统可以根据业务逻辑自动发送短信，大幅提升效率。

API接入的典型应用场景

• 用户注册/登录验证码（OTP）
• 订单状态变更自动通知
• 预约提醒自动发送
• 营销活动自动触发
• 系统告警通知

API接入基础流程

第一步：获取API凭证

注册河马全球短信群发账户后，在控制台的"API设置"中获取您的API Key和Secret。请妥善保管这些凭证，不要泄露给第三方。

第二步：查阅API文档

详细阅读API文档，了解接口地址、请求格式、响应格式、错误码等信息。

第三步：开发测试

在测试环境中进行API调用测试，确认功能正常后再部署到生产环境。

第四步：正式上线

完成测试后，切换到正式API端点，开始实际业务发送。

示例代码（PHP）

$apiKey = "your_api_key";
$apiSecret = "your_api_secret";
$to = "+8613800138000";
$content = "您的验证码是：123456，5分钟内有效。";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.hipposms.com/v1/send");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
    "to" => $to,
    "content" => $content,
    "apiKey" => $apiKey
]));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

常见问题

Q：API支持哪些编程语言？
A：我们提供PHP、Python、Java、Node.js、Go等多种语言的SDK，也可通过HTTP接口直接调用。

Q：发送失败如何处理？
A：API会返回详细的错误码和描述，支持失败重发机制，平台也提供回调（Webhook）通知发送状态。

Q：如何查询发送记录？
A：可通过API查询接口或登录控制台查看详细的发送日志和统计报表。