快速开始
本指南将帮助您快速集成天福诺 API 服务。
第一步：准备工作
1. 注册账户
联系天福诺信息获取 API 访问权限。
2. 获取凭证
获取以下必要信息：
- SpCode（企业编号）
- 接口访问地址
- API 密钥
第二步：选择 API
短信服务
彩信服务
第三步：发送第一条消息
示例：发送普通短信
http
POST /sms/send HTTP/1.1
Host: api.tfn.com
Content-Type: application/x-www-form-urlencoded
SpCode=your_spcode&LoginName=your_login&Password=your_password&MessageContent=Hello&UserNumber=13800138000&SerialNumber=123456&ScheduleTime=&SignName=【天福诺】&subPort=*示例响应
State=1&MessageId=1234567890&Describe=success第四步：处理响应
检查响应中的 State 字段：
State=1：发送成功- 其他值：发送失败，查看
Describe了解原因
第五步：状态监控
主动查询
使用 短信状态报告 查询发送状态。
接收推送
配置 短信状态推送 接收实时状态更新。
常见问题和解决方案
Q: 收不到短信怎么办？
A: 检查以下几点：
- 账户余额是否充足
- 手机号码格式是否正确
- 查看 短信状态报告 了解具体状态
Q: 如何提高发送成功率？
A:
- 使用 空号检测 过滤无效号码
- 避免发送敏感词汇
- 合理设置发送频率
最佳实践
1. 错误重试
实现适当的错误重试机制，避免频繁重试。
2. 日志记录
记录所有 API 调用和响应，便于问题排查。
3. 频率控制
遵守 API 频率限制，避免被封禁。
4. 数据安全
- 不要在前端暴露 API 密钥
- 使用 HTTPS 加密传输
- 定期更新访问凭证
获取帮助
如果遇到问题，请：