API 文档
接口地址: https://api.gugudata.com/sms/internationalphone
返回格式: application/json; charset=utf-8
请求方式: GET
请求协议: HTTPS
请求示例: https://api.gugudata.com/sms/internationalphone?appkey=YOUR_APPKEY&phone=%2b1(817)+569-8900&countrycode=USA
数据预览: https://www.gugudata.com/preview/internationalphone
接口测试: https://api.gugudata.com/sms/internationalphone/demo
OpenAPI: https://www.gugudata.com/openapi/gugudata.openapi.3.1.json
| 参数名 |
参数类型 |
是否必须 |
默认值 |
备注 |
| appkey |
string |
是 |
无 |
使用已授权的 APPKEY,兼容现有有效鉴权位置。 |
| phone |
string |
是 |
无 |
待检查的号码字符串,支持现有国际格式;指定国家时也可传该国号码。 |
| countrycode |
string |
否 |
无 |
可选国家代码,支持现有两字母、三字母及大小写表达;不传时沿用国际号码解析规则。 |
| 参数名 |
参数类型 |
备注 |
| DataStatus.RequestParameter |
string |
实际、可读业务请求参数,不包含凭据。 |
| DataStatus.StatusCode |
integer |
成功为 100;参数错误为 501;处理或依赖失败为 901。 |
| DataStatus.StatusDescription |
string |
业务状态说明。 |
| DataStatus.ResponseDateTime |
string |
接口返回时间。 |
| DataStatus.DataTotalCount |
integer |
实际结果数量。 |
| Data |
object |
数据结果。 |
| Data.IsValid |
boolean |
号码是否符合现有号码规则;false 仍是成功完成校验。 |
| Data.SourceMobileNumber |
string |
保留现有输入号码回显规则;正式接口移除 +。 |
| Data.CorrectedMobileNumber |
string |
有效时返回规范化国际号码,无效时为空字符串。 |
| Data.CountryCode |
string |
有效时返回国际拨号前缀。 |
| Data.CountryCode2 |
string |
有效时返回两字母国家代码。 |
| Data.CountryCode3 |
string |
有效时返回三字母国家代码。 |
{
"DataStatus": {
"RequestParameter": "phone=+1(817) 569-8900&countrycode=USA",
"StatusCode": 100,
"StatusDescription": "请求成功。",
"ResponseDateTime": "2026-10-23 15:06:18.270",
"DataTotalCount": 1
},
"Data": {
"IsValid": true,
"SourceMobileNumber": "1(817) 569-8900",
"CorrectedMobileNumber": "+18175698900",
"CountryCode": "+1",
"CountryCode2": "US",
"CountryCode3": "USA"
}
}