靓号

评论模块

GET 获取评论 /api/comment_controller/index

获取评论

权限

登录	否
鉴权	否

Headers

无

参数

名称	类型	必选	描述
commentable_type	string	是	评论类型,video：评论
commentable_id	string	是	评论类型id

正文

无

参数

追加

commentable_type

commentable_id

响应输出

返回参数

名称	类型	描述
body	string	评论内容
created_at	string	发布时间
user[nickname]	string	用户昵称
user[avatar]	string	用户头像

无

GET 发表评论 /api/comment_controller/post

发表评论

权限

登录	是
鉴权	否

Headers

无

参数

名称	类型	必选	描述
body	string	是	内容
commentable_type	string	是	评论类型,info：资讯,video:视频
commentable_id	string	是	评论类型id

正文

无

参数

追加

body

commentable_type

commentable_id

响应输出

返回参数

名称	类型	描述
score	string	获得的积分数量

无

公共接口

GET 获取各种协议 /api/common/agreement

获取各种协议

权限

登录	否
鉴权	否

Headers

无

参数

名称	类型	必选	描述
id	int	是	1入网许可协议2个人信息收集证明3查询订单说明4商务合作说明5隐私权政策6法律责任风险提示告知书

正文

无

参数

追加

响应输出

返回参数

名称	类型	描述
title	string	标题
content	string	内容

无

GET 获取轮播图 /api/common/ads

获取轮播图

权限

登录	否
鉴权	否

Headers

无

参数

名称	类型	必选	描述
pos	string	是	位置index首页

正文

无

参数

追加

响应输出

返回参数

名称	类型	描述
img	string	图片地址
link	string	链接

无

POST 上传文件 /api/common/upload

上传文件

权限

登录	否
鉴权	否

Headers

无

参数

名称	类型	必选	描述
file	File	是	文件流

正文

无

参数

追加

响应输出

返回参数

无

无

GET 意见反馈 /api/common/feedback

意见反馈

权限

登录	否
鉴权	否

Headers

无

参数

名称	类型	必选	描述
name	string	是	称呼
phone	string	是	电话
sms_code	string	是	验证码
title	string	是	标题
content	string	是	内容
images	string	是	图片数组

正文

无

参数

追加

name

phone

sms_code

title

content

images

响应输出

返回参数

无

无

GET 商务合作 /api/common/business_form

商务合作

权限

登录	否
鉴权	否

Headers

无

参数

名称	类型	必选	描述
type	string	是	1个人2公司
name	string	是	名称
for	string	是	方向1直播合作2学习直播3卡商合作
has_exp	string	是	1有0无经验
phone	string	是	手机号
sms_code	string	是	验证码

正文

无

参数

追加

type

name

for

has_exp

phone

sms_code

响应输出

返回参数

无

无

GET 获取地区信息 /api/common/area

获取地区信息

权限

登录	否
鉴权	否

Headers

无

参数

名称	类型	必选	描述
level	string	是	1省2市3区
pid	string	是	上级区域ID

正文

无

参数

追加

level

pid

响应输出

返回参数

无

无

GET 获取地区信息(按字母排序) /api/common/area_sort

获取地区信息(按字母排序)

权限

登录	否
鉴权	否

Headers

无

参数

无

正文

无

参数

追加

响应输出

返回参数

无

无

GET 地区递归三级联动 /api/common/area_tree

地区递归三级联动

权限

登录	否
鉴权	否

Headers

无

参数

无

正文

无

参数

追加

响应输出

返回参数

无

无

GET 根据名称获取信息 /api/common/get_area

根据名称获取信息

权限

登录	否
鉴权	否

Headers

无

参数

名称	类型	必选	描述
name	string	是	城市名

正文

无

参数

追加

响应输出

返回参数

名称	类型	描述
id	string	城市ID

无

GET 获取系统配置 /api/common/config

获取系统配置

权限

登录	否
鉴权	否

Headers

无

参数

无

正文

无

参数

追加

响应输出

返回参数

名称	类型	描述
site_name	string	站点名称
com_name	string	公司名称
wxp_name	string	微信公众号名称
wxp_qrcode	string	微信公众号二维码
service_mobile	string	客服手机号
service_work_time	string	客服工作时间
system_sms_open	string	短信验证码开关
disable_send_province	string	禁止发货地区
system_index_tr	string	首页右上角展示1投诉2商务合作
system_index_m1	string	首页特价号1流量卡2号码定制

无

首页

靓号管理

POST 列表 /api/mobile_controller/list

列表

权限

登录	否
鉴权	否

Headers

无

参数

名称	类型	必选	描述
type	string	是	1靓号，2流量卡,默认1
search_type	string	是	fuzzy模糊，precise精准
search_last	string	是	0,1是否搜索尾部
city_id	string	是	地区id
keyword	string	是	搜索内容,模糊就是字符串，精准就是数组
sort	string	是	price_asc价格从低到高,price_desc价格从高到低
network	string	是	网络
price_min	string	是	价格最低数字
price_max	string	是	价格最高数字
exclude_num	string	是	排除数字
num_max	string	是	数字较多，传数字
rule_position	string	是	规律位置,middle中间，tail尾部
rule_name	string	是	规律名，AAAA什么的
limit	string	是	limit
page	string	是	page

正文

无

参数

追加

type

search_type

search_last

city_id

keyword

sort

network

price_min

price_max

exclude_num

num_max

rule_position

rule_name

limit

page

响应输出

返回参数

名称	类型	描述
id	string	id
type	string	1靓号，2流量卡
logo	string	缩略图
name	string	号码名称
no	string	手机号
type	string	1靓号2流量卡
network	string	运营商
city	string	城市
privince	string	省份
amount	string	售价
amount_original	string	原价
amount_exists	string	含话费
amount_base	string	售价
amount_charge	string	预充
summary	string	简介
saled	string	是否已出售
status	string	0正常1已售2已下架
is_activity	string	是否特价号
activity_time_end	string	特价过期时间null永不过期
view_count	string	正在浏览人数
info.free_app	string	免流APP列表
info.describe	string	套餐说明\|资费详情
info.content	string	详细内容\|注意事项
info.flow_year	string	每年流量(G
info.fee	string	资费
info.first_month_free	string	首月是否免月租
info.discount_title	string	简要优惠介绍
info.flow_free_limit	string	前多少名免单

无

GET 号码详情 /api/mobile_controller/show

号码详情

权限

登录	否
鉴权	否

Headers

无

参数

名称	类型	必选	描述
id	string	是	号码id

正文

无

参数

追加

响应输出

返回参数

无

无

POST 下单 /api/mobile_controller/apply

下单

权限

登录	否
鉴权	否

Headers

无

参数

名称	类型	必选	描述
mobile_id	string	是	手机号ID
name	string	是	姓名
phone	string	是	手机号
sms_code	string	是	验证码
id_no	string	是	身份号码
county	string	是	城市ID,区县id
address	string	是	详细地址
remark	string	是	备注
pay_type	string	是	1微信2支付宝3京东
return_url	string	是	支付完成回调页面链接

正文

无

参数

追加

mobile_id

name

phone

sms_code

id_no

county

address

remark

pay_type

return_url

响应输出

返回参数

名称	类型	描述
pay_url	string	支付链接

无

GET 继续支付 /api/mobile_controller/continue_pay

继续支付

权限

登录	否
鉴权	否

Headers

无

参数

名称	类型	必选	描述
id	string	是	订单id
pay_type	string	是	支付方式与下单一样
return_url	string	是	支付完成回调页面链接

正文

无

参数

追加

pay_type

return_url

响应输出

返回参数

无

无

GET 订单详情 /api/mobile_controller/order_detail

订单详情

权限

登录	否
鉴权	否

Headers

无

参数

名称	类型	必选	描述
id	string	是	订单id

正文

无

参数

追加

响应输出

返回参数

名称	类型	描述
no	string	手机号
order_no	string	订单号
amount_hd	string	活动价
amount_original	string	原价
amount_charge	string	预充
describe	string	套餐说明
proxy.wx_qr	string	客服二维码
name	string	收货人
phone	string	收货人手机号
id_no	string	收货人身份证
address	string	收货地址
remark	string	备注
create_time	string	下单时间
amount	string	订单金额
trans_name	string	快递名称
trans_no	string	快递单号
status	string	0=>'待付款',10=>'已付款',15=>'可发货',17=>'有号码未发货',20=>'待开卡',25=>'已完成',30=>'申请退款',50=>'已关闭',60=>'无号码',70=>'换卡',80=>'争议单',90=>'已退款',
open_uploaded	string	是否已上传开卡资料
open_idcard_face_img	string	身份证正面照
open_idcard_back_img	string	身份证反面照
open_face_img	string	头像照
open_name	string	姓名
open_id_no	string	身份证号码
open_phone	string	手机号
pay_time	string	支付时间
expire_time	string	过期时间

无

GET 订单列表 /api/mobile_controller/order_list

订单列表

权限

登录	否
鉴权	否

Headers

无

参数

名称	类型	必选	描述
page	string	是	page
limit	string	是	limit
phone	string	是	手机号

正文

无

参数

追加

page

limit

phone

响应输出

返回参数

无

无

GET 筛选配置 /api/mobile_controller/config

筛选配置

权限

登录	否
鉴权	否

Headers

无

参数

无

正文

无

参数

追加

响应输出

返回参数

无

无

GET 上传开卡资料 /api/mobile_controller/upload_identity

上传开卡资料

权限

登录	否
鉴权	否

Headers

无

参数

名称	类型	必选	描述
id	string	是	订单id
idcard_face_img	string	是	身份证正面照片
idcard_back_img	string	是	身份证反面照片
face_img	string	是	本人照片
name	string	是	本人姓名
id_no	string	是	本人身份证号码
phone	string	是	本人联系电话

正文

无

参数

追加

idcard_face_img

idcard_back_img

face_img

name

id_no

phone

响应输出

返回参数

无

无

GET 预定号码 /api/mobile_controller/order_no

预定号码

权限

登录	否
鉴权	否

Headers

无

参数

名称	类型	必选	描述
no	string	是	号码
price_min	string	是	最低承受价格
price_max	string	是	最高承受价格
remark	string	是	备注
name	string	是	姓名
phone	string	是	联系电话
county	string	是	区县ID
address	string	是	详细地址

正文

无

参数

追加

price_min

price_max

remark

name

phone

county

address

响应输出

返回参数

无

无

GET 横幅播报 /api/mobile_controller/ordered_show

横幅播报

权限

登录	否
鉴权	否

Headers

无

参数

无

正文

无

参数

追加

响应输出

返回参数

名称	类型	描述
ordered_num	string	已订购人数
no	string	号码
name	string	人名

无

POST 退款 /api/mobile_controller/refund

退款

权限

登录	否
鉴权	否

Headers

无

参数

名称	类型	必选	描述
id	string	是	订单id
reason	string	是	退款原因

正文

无

参数

追加

reason

响应输出

返回参数

无

无

手机短信接口

POST 发送验证码 /api/sms/send

发送验证码

权限

登录	否
鉴权	否

Headers

无

参数

名称	类型	必选	描述
mobile	string	是	手机号asdasdas
event	string	是	事件名称,changemobile更换手机号,changepwd修改密码,resetpwd重置密码,mobilelogin登录,提交订单order,商务合作cooperate，投诉complaint

正文

无

参数

追加

mobile

event

响应输出

返回参数

无

无

POST 检测验证码 /api/sms/check

检测验证码

权限

登录	否
鉴权	否

Headers

无

参数

名称	类型	必选	描述
mobile	string	是	手机号
event	string	是	事件名称
captcha	string	是	验证码

正文

无

参数

追加

mobile

event

captcha

响应输出

返回参数

无

无

Token接口

GET 检测Token是否过期 /api/token/check

检测Token是否过期

权限

登录	是
鉴权	是

Headers

无

参数

无

正文

无

参数

追加

响应输出

返回参数

无

无

GET 刷新Token /api/token/refresh

刷新Token

权限

登录	是
鉴权	是

Headers

无

参数

无

正文

无

参数

追加

响应输出

返回参数

无

无

会员接口

GET 会员信息 /api/user/index

会员信息

权限

登录	是
鉴权	否

Headers

无

参数

无

正文

无

参数

追加

响应输出

返回参数

名称	类型	描述
id	string	用户ID
username	string	用户名
nickname	string	昵称
mobile	string	手机号
avatar	string	头像
age	string	年龄
gender	string	性别1男2女
level_text	string	会员级别标题
level	string	会员级别,0游客10安检员20正式会员
money	string	余额
has_follow	string	是否关注
verification	string	认证信息
province	string	省对象
city	string	市对象
county	string	县对象
wenda_num	string	问答记录数量
follow_count	string	关注数量
has_answered	string	是否已答过题
userinfo[custom][key]	string	自定义资料key
userinfo[custom][title]	string	自定义资料名称
userinfo[custom][value]	string	自定义资料值

无

POST 小程序登录 /api/user/minilogin

小程序登录

权限

登录	否
鉴权	否

Headers

无

参数

名称	类型	必选	描述
code	string	是	小程序code
mob_brand	string	是	手机品牌
mob_model	string	是	手机型号

正文

无

参数

追加

code

mob_brand

mob_model

响应输出

返回参数

无

无

GET 微信公众号登录获取参数 /api/user/wxp

微信公众号登录获取参数

权限

登录	否
鉴权	否

Headers

无

参数

名称	类型	必选	描述
redirect_uri	string	是	跳转链接

正文

无

参数

追加

响应输出

返回参数

无

无

GET 签到 /api/user/sign

签到

权限

登录	是
鉴权	否

Headers

无

参数

无

正文

无

参数

追加

响应输出

返回参数

名称	类型	描述
score	string	赠送积分数量

无

GET 已签到日期列表 /api/user/sign_list

已签到日期列表

权限

登录	是
鉴权	否

Headers

无

参数

名称	类型	必选	描述
date	string	是	月份，2020-02

正文

无

参数

追加

响应输出

返回参数

无

无

GET 关注列表 /api/user/my_follow

关注列表

权限

登录	是
鉴权	否

Headers

无

参数

名称	类型	必选	描述
limit	string	是	每页数量
page	string	是	第几页

正文

无

参数

追加

limit

page

响应输出

返回参数

名称	类型	描述
id	string	博主ID
name	string	名称
logo	string	logo

无

GET 关注取消关注博主 /api/user/follow

关注取消关注博主

权限

登录	是
鉴权	否

Headers

无

参数

名称	类型	必选	描述
id	string	是	博主ID
status	string	是	1关注2取消

正文

无

参数

追加

status

响应输出

返回参数

无

无

GET 授权获取手机号 /api/user/wx_mobile

授权获取手机号

权限

登录	是
鉴权	否

Headers

无

参数

名称	类型	必选	描述
code	string	是	小程序code
encryptedData	string	是	encryptedData
iv	string	是	iv

正文

无

参数

追加

code

encryptedData

响应输出

返回参数

无

无

POST 重置密码 /api/user/resetpwd

重置密码

权限

登录	否
鉴权	否

Headers

无

参数

名称	类型	必选	描述
mobile	string	是	手机号
newpassword	string	是	新密码
captcha	string	是	验证码

正文

无

参数

追加

mobile

newpassword

captcha

响应输出

返回参数

无

无

POST 会员登录 /api/user/login

会员登录

权限

登录	否
鉴权	否

Headers

无

参数

名称	类型	必选	描述
account	string	是	账号
password	string	是	密码

正文

无

参数

追加

account

password

响应输出

返回参数

无

无

POST 第三方登录 /api/user/third

第三方登录

权限

登录	否
鉴权	否

Headers

无

参数

名称	类型	必选	描述
platform	string	是	平台名称
code	string	是	Code码

正文

无

参数

追加

platform

code

响应输出

返回参数

无

无

POST 修改手机号 /api/user/changemobile

修改手机号

权限

登录	是
鉴权	否

Headers

无

参数

名称	类型	必选	描述
mobile	string	是	手机号
captcha	string	是	验证码

正文

无

参数

追加

mobile

captcha

响应输出

返回参数

无

无

POST 修改邮箱 /api/user/changeemail

修改邮箱

权限

登录	否
鉴权	否

Headers

无

参数

名称	类型	必选	描述
email	string	是	邮箱
captcha	string	是	验证码

正文

无

参数

追加

captcha

响应输出

返回参数

无

无

POST 退出登录 /api/user/logout

退出登录

权限

登录	是
鉴权	否

Headers

无

参数

无

正文

无

参数

追加

响应输出

返回参数

无

无

POST 修改会员个人信息 /api/user/profile

修改会员个人信息

权限

登录	是
鉴权	否

Headers

无

参数

名称	类型	必选	描述
avatar	string	是	头像地址
nickname	string	是	昵称
bio	string	是	个人简介
age	string	是	年龄
gender	string	是	性别1男2女
county_id	string	是	区县ID
custom[xxxx]	string	是	自定义资料放这里

正文

无

参数

追加

avatar

nickname

bio

age

gender

county_id

custom[xxxx]

响应输出

返回参数

名称	类型	描述
score	string	赠送的积分数量

无

POST 注册会员 /api/user/register

注册会员

权限

登录	否
鉴权	否

Headers

无

参数

名称	类型	必选	描述
username	string	是	用户名
password	string	是	密码
email	string	是	邮箱
mobile	string	是	手机号
code	string	是	验证码

正文

无

参数

追加

username

password

mobile

code

响应输出

返回参数

无

无

POST 手机验证码登录 /api/user/mobilelogin

手机验证码登录

权限

登录	否
鉴权	否

Headers

无

参数

名称	类型	必选	描述
mobile	string	是	手机号
captcha	string	是	验证码

正文

无

参数

追加

mobile

captcha

响应输出

返回参数

无

无

GET 微信公众号登录 /api/user/wxp_handle

微信公众号登录

权限

登录	是
鉴权	否

Headers

无

参数

名称	类型	必选	描述
code	string	是	微信code

正文

无

参数

追加

响应输出

返回参数

名称	类型	描述
userinfo.nickname	string	昵称
userinfo.avatar	string	头像

无

用户端地址模块

GET 列表 /api/user_address_controller/list

列表

权限

登录	是
鉴权	否

Headers

无

参数

无

正文

无

参数

追加

响应输出

返回参数

名称	类型	描述
id	string	id
name	string	姓名
mobile	string	手机号码
address	string	详细地址
city	string	所在城市
city_detail	string	所在城市名
longitude	string	经度
latitude	string	纬度
location	string	所在地区

无

GET 新增或修改地址 /api/user_address_controller/edit

新增或修改地址

权限

登录	是
鉴权	否

Headers

无

参数

名称	类型	必选	描述
id	string	是	id，修改的时候必须
name	string	是	姓名
mobile	string	是	手机号
city	string	是	区县名字
address	string	是	详细地址
is_default	string	是	1和0，是否默认

正文

无

参数

追加

name

mobile

city

address

is_default

响应输出

返回参数

无

无

GET 地址详情 /api/user_address_controller/detail

地址详情

权限

登录	是
鉴权	否

Headers

无

参数

名称	类型	必选	描述
id	string	是	id

正文

无

参数

追加

响应输出

返回参数

名称	类型	描述
name	string	姓名
mobile	string	手机号码
address	string	详细地址
city	string	所在城市
city_detail	string	所在城市名
longitude	string	经度
latitude	string	纬度
location	string	所在地区

无

GET 删除地址 /api/user_address_controller/delete

删除地址

权限

登录	是
鉴权	否

Headers

无

参数

名称	类型	必选	描述
id	string	是	id

正文

无

参数

追加

响应输出

返回参数

无

无

验证接口

POST 检测邮箱 /api/validate/check_email_available

检测邮箱

权限

登录	否
鉴权	否

Headers

无

参数

名称	类型	必选	描述
email	string	是	邮箱
id	string	是	排除会员ID

正文

无

参数

追加

响应输出

返回参数

无

无

POST 检测用户名 /api/validate/check_username_available

检测用户名

权限

登录	否
鉴权	否

Headers

无

参数

名称	类型	必选	描述
username	string	是	用户名
id	string	是	排除会员ID

正文

无

参数

追加

username

响应输出

返回参数

无

无

POST 检测昵称 /api/validate/check_nickname_available

检测昵称

权限

登录	否
鉴权	否

Headers

无

参数

名称	类型	必选	描述
nickname	string	是	昵称
id	string	是	排除会员ID

正文

无

参数

追加

nickname

响应输出

返回参数

无

无

POST 检测手机 /api/validate/check_mobile_available

检测手机

权限

登录	否
鉴权	否

Headers

无

参数

名称	类型	必选	描述
mobile	string	是	手机号
id	string	是	排除会员ID

正文

无

参数

追加

mobile

响应输出

返回参数

无

无

POST 检测手机 /api/validate/check_mobile_exist

检测手机

权限

登录	否
鉴权	否

Headers

无

参数

名称	类型	必选	描述
mobile	string	是	手机号

正文

无

参数

追加

响应输出

返回参数

无

无

POST 检测邮箱 /api/validate/check_email_exist

检测邮箱

权限

登录	否
鉴权	否

Headers

无

参数

名称	类型	必选	描述
mobile	string	是	邮箱

正文

无

参数

追加

响应输出

返回参数

无

无

POST 检测手机验证码 /api/validate/check_sms_correct

检测手机验证码

权限

登录	否
鉴权	否

Headers

无

参数

名称	类型	必选	描述
mobile	string	是	手机号
captcha	string	是	验证码
event	string	是	事件

正文

无

参数

追加

mobile

captcha

event

响应输出

返回参数

无

无

POST 检测邮箱验证码 /api/validate/check_ems_correct

检测邮箱验证码

权限

登录	否
鉴权	否

Headers

无

参数

名称	类型	必选	描述
email	string	是	邮箱
captcha	string	是	验证码
event	string	是	事件

正文

无

参数

追加

captcha

event

响应输出

返回参数

无

无