携号转网

接口描述

请求URL：/admin-api/open/mobile/portability
请求方式：POST
请求类型：application/json

请求参数

字段名	变量名	必填	类型	示例值	描述
手机号	mobile	是	String	15700000000	手机号码

请求示例数据

json

{
  "mobile": "15700000000"
}

返回参数

字段名	变量名	必填	类型	示例值	描述
返回状态	code	是	int	0	0-处理成功，其他-处理有误，详见错误码
返回信息	msg	否	String	success	具体错误原因，例如：参数格式校验错误
返回数据	data	否	String	{}	返回数据,json格式数据
响应时间	time	否	String	1748419530971	请求响应时间

data数据格式

字段名	变量名	必填	类型	示例值	描述
手机号	mobile	是	String	15700000000	手机号码
请求ID	requestId	否	String	2533	请求ID
转网状态	isPortability	是	int	1	1已携号转网 0未转网
初始运营商类型	initOperator	否	int	1	0未知 1移动 2联通 3电信 4广电
携号转网后的运营商类型	nowOperator	是	int	1	0未知 1移动 2联通 3电信 4广电
省份	province	是	String	广东	省份
城市	city	是	String	广州市	城市
初始运营商	operator	是	int	1	0未知 1移动 2联通 3电信 4广电

返回示例数据

json

{
  "code": 0,
  "data": {
    "mobile": "15700000000",
    "requestId": "2533",
    "isPortability": 0,
    "initOperator": 1,
    "nowOperator": 1,
    "province": "广东",
    "city": "广州市",
    "operator": 1
  },
  "msg": "请求成功",
  "time": 1748421690372
}

状态码

系统级状态码

系统状态码

描述

备注

请求成功

400

请求参数错误

429

请求过于频繁，请稍后重试

400000

签名无效

请检查签名算法

1000015

缺少参数

检查请求头格式是否缺少请求头

1002023000

商户不存在/非法商户密钥

1002023002

商户已被禁用

1002023008

套餐剩余次数已用完了, 请及时续购

2003000000

调用异常，请联系管理员检查

请联系租户检查日志信息

2003000100

请填写正确的手机号码

2003000101

未查询到相关信息

携号转网 ​

接口描述 ​

请求参数 ​

请求示例数据 ​

返回参数 ​

data数据格式 ​

返回示例数据 ​

状态码 ​