## 一、接口基础规范与接入准备

针对智利短信接口的对接，开发者首先需要明确接口的基础通信规范，避免因协议不匹配导致的基础请求失败。
### 1. 通信基础规则

该接口支持 GET 与 POST 两种请求方式，全局采用 UTF-8 字符编码，使用 POST 方式请求时，需将请求头`Content-Type`设置为固定值`application/x-www-form-urlencoded`。接口支持全天 24 小时提交请求，可适配验证码触发、业务通知等不同时效性要求的场景。
### 2. 接入前置凭证

接口采用账号密码鉴权机制，开发者需要提前获取 APIID 与 APIKEY 作为调用凭证。在主流云通信服务商的方案中，国际短信服务可提供统一的接口适配，开发者可在对应产品控制台查看国际短信模块的接入凭证。
## 二、核心请求参数与响应规则拆解

完成凭证准备后，开发者需要精准掌握智利短信接口的请求参数规则与响应处理逻辑，这是保障接口正常调用的核心环节。
### 1. 请求参数说明

接口参数分为必填项与选填项，所有参数需严格遵循格式要求：

- `account`：必填，APIID 账号，作为接口鉴权的身份标识

- `password`：必填，支持直接传入 APIKEY，或传入结合时间戳生成的动态加密密码

- `mobile`：必填，接收方手机号码，单次仅支持提交 1 个号码，格式严格遵循「国家号 + 空格 + 手机号」，智利地区国家码为 56，示例格式为`56 9****1234`

- `content`：必填，国际短信内容，需符合对应地区的内容合规要求

- `time`：选填，10 位 Unix 时间戳，仅在使用动态密码鉴权时为必填项

### 2. 响应结构与状态码

接口统一返回 JSON 格式响应，核心包含三个字段：`code`为状态码、`msg`为结果描述、`ismsid`为提交成功后的流水号（失败时为 0 或空值）。

常见核心状态码如下：

- `code=2`：提交成功，可通过 ismsid 后续跟进短信送达状态

- `code=401`：账号参数为空，需检查 account 字段是否正常传递

- `code=406`：手机号码格式错误，需核对国家码与号码间的空格是否缺失

- `code=405`：用户名或密码错误，需核对鉴权凭证，或检查动态密码的加密逻辑

- `code=407`：短信内容含有敏感字符，需调整短信内容后重新提交

## 三、实战对接：PHP 实现短信发送

下面通过完整的 PHP 代码示例，演示智利短信接口的动态密码鉴权与请求发送流程，开发者可直接基于示例改造适配自身业务。
```
<?php
// 国际短信接口调用示例
header("Content-type:text/html; charset=UTF-8");

// 基础配置参数
$account = 'xxxxxxxx'; // 控制台获取的APIID
$apiKey = 'xxxxxxxxx'; // 控制台获取的APIKEY
$mobile = '56 9****1234'; // 智利手机号，格式：国家码+空格+手机号
$content = 'Your verification code is 1125'; // 短信发送内容
$time = (string)time(); // 生成10位Unix时间戳

// 生成动态密码：按顺序拼接参数后MD5加密，所有参数统一UTF-8编码
$password = md5($account . $apiKey . $mobile . $content . $time);


// 构造POST请求参数
$postData = http_build_query([
    'account' => $account,
    'password' => $password,
    'mobile' => $mobile,
    'content' => $content,
    'time' => $time
]);

// 初始化curl发送请求
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $postData);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 10);

// 执行请求并处理响应
$response = curl_exec($ch);
curl_close($ch);

// 解析JSON响应结果
$result = json_decode($response, true);
if ($result['code'] == 2) {
    echo "提交成功，流水号：" . $result['ismsid'];
} else {
    echo "提交失败，错误码：" . $result['code'] . "，错误信息：" . $result['msg'];
}
?>
```

上述示例采用动态密码鉴权模式，相比固定密码模式具备更高的安全性。需要注意的是，所有参与 MD5 加密的参数需保持与请求参数完全一致，且统一为 UTF-8 编码，避免编码差异导致鉴权失败。
## 四、常见问题排查与开发优化技巧

在实际对接过程中，开发者常会遇到参数校验失败、鉴权不通过等问题，以下总结核心排查与优化技巧，提升开发调试效率。
### 1. 高频异常排查要点

1. 手机号格式错误：若返回 406 状态码，优先检查是否遗漏国家码与手机号之间的空格，智利地区号码需确认国家码为 56，避免直接提交不带国家码的本地号码。

2. 鉴权失败问题：返回 405 状态码时，固定密码模式需核对 APIID 与 APIKEY 是否匹配；动态密码模式需检查加密参数的拼接顺序、编码格式与时间戳有效性。

3. 参数缺失问题：返回 401、402、403、404 等状态码时，对应检查 account、password、mobile、content 四个必填参数是否为空或未正确传递。

### 2. 工程化优化建议

- 幂等性设计：建议为每一次短信请求生成唯一请求 ID，结合有限次重试机制避免网络波动导致的重复发送问题

- 异步处理：业务高峰期可将短信请求写入异步队列，削峰填谷的同时降低接口超时对主业务流程的影响

- 错误监控：针对非 2 状态码的响应建立分级告警机制，及时发现凭证余额不足、内容违规等异常问题

针对智利短信接口的对接，开发者首先需要明确接口的基础通信规范，避免因协议不匹配导致的基础请求失败。

智利短信接口如何接入？

在国际电商、国际身份验证、企业全球化业务通知等场景中，智利地区的短信稳定触达是不少开发者需要处理的技术需求。本文将系统讲解智利短信接口的接入流程、参数规范与异常排查方案，覆盖请求构造、鉴权逻辑、错误处理全流程，帮助开发者快速完成国际短信能力集成，规避格式校验、鉴权失败等常见开发问题，缩短功能上线周期。

编程语言

智利短信接口对接指南：详解通信规范、参数格式与PHP实现。支持GET/POST请求，需UTF-8编码和账号密码鉴权。必填参数包括APIID、APIKEY、手机号（56开头）和短信内容。提供PHP代码示例，涵盖动态密码生成、CURL请求和响应处理。常见错误排查要点：手机号格式、鉴权失败、参数缺失等。优化建议包括幂等性设计、异步处理和错误监控机制。

代码解释

验证码

短信

JSON

Unix

国内短信特惠0.04元/条起，接入便捷，稳定可靠


腾讯云 IM，全球通信，1折起


文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

智利短信接口对接指南：详解通信规范、参数格式与PHP实现。支持GET/POST请求，需UTF-8编码和账号密码鉴权。必填参数包括APIID、APIKEY、手机号（56开头）和短信内容。提供PHP代码示例，涵盖动态密码生成、CURL请求和响应处理。常见错误排查要点：手机号格式、鉴权失败、参数缺失等。优化建议包括幂等性设计...

智利短信接口如何接入？-腾讯云开发者社区-腾讯云

智利短信接口如何接入？

智利短信接口如何接入？

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐