相对论

公共接口

GET 加载初始化 /api/common/init

加载初始化

权限

登录	否
鉴权	否

Headers

无

参数

名称	类型	必选	描述
version	string	是	版本号
lng	string	是	经度
lat	string	是	纬度

正文

无

参数

追加

version

lng

lat

响应输出

返回参数

无

无

POST 上传文件 /api/common/upload

上传文件

权限

登录	是
鉴权	否

Headers

无

参数

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

正文

无

参数

追加

响应输出

返回参数

无

无

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

获取系统配置

权限

登录	否
鉴权	否

Headers

无

参数

名称	类型	必选	描述
'site'	string	是	'officialwx官方微信 money狗粮充值配置 score喜欢数量充值配置 PrivacyAgreement隐私协议 VerifyAuthorization验证授权书用户服务协议UserServiceAgreement 关于我们AboutUs 狗粮用户协议DogFoodUserAgreement 公众号图片 official_account_img 公众号文本 official_account_text'

正文

无

参数

追加

响应输出

返回参数

无

无

GET 获取分类 /api/common/category

获取分类

权限

登录	否
鉴权	否

Headers

无

参数

名称	类型	必选	描述
'type'	string	是	'education学历分类 tag标签 reason_cancellation注销列表'

正文

无

参数

追加

响应输出

返回参数

无

无

GET 生成订单号 /api/common/getOrderId

生成订单号

权限

登录	是
鉴权	否

Headers

无

参数

无

正文

无

参数

追加

响应输出

返回参数

无

无

GET 获取openid /api/common/getOpenid

获取openid

权限

登录	是
鉴权	否

Headers

无

参数

名称	类型	必选	描述
code	string	是

正文

无

参数

追加

响应输出

返回参数

无

无

GET 选择项 /api/common/selection

选择项

权限

登录	否
鉴权	否

Headers

无

参数

名称	类型	必选	描述
type	string	是	1年龄 2身高 3计划结婚

正文

无

参数

追加

响应输出

返回参数

无

无

GET 获取所有地区 /api/common/getAllArea

获取所有地区

权限

登录	是
鉴权	否

Headers

无

参数

无

正文

无

参数

追加

响应输出

返回参数

无

无

GET 获取所有的省市 /api/common/get_area_city

获取所有的省市

权限

登录	是
鉴权	否

Headers

无

参数

无

正文

无

参数

追加

响应输出

返回参数

无

无

GET 根据城市id获取下一级 /api/common/get_area

根据城市id获取下一级

权限

登录	是
鉴权	否

Headers

无

参数

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

正文

无

参数

追加

响应输出

返回参数

无

无

示例接口

POST 测试名称 /api/demo/test/id/{id}/name/{name}

测试描述信息

权限

登录	否
鉴权	否

Headers

名称	类型	必选	描述
token	string	是	请求的Token

参数

名称	类型	必选	描述
id	integer	是	会员ID
name	string	是	用户名
data	object	是	扩展数据

正文

无

Headers

token

参数

追加

name

data

响应输出

返回参数

名称	类型	描述
code	integer
msg	string
data	object	扩展数据返回

{
         'code':'1',
         'msg':'返回成功'
        }

GET 无需登录的接口 /api/demo/test1

无需登录的接口

权限

登录	否
鉴权	否

Headers

无

参数

无

正文

无

参数

追加

响应输出

返回参数

无

无

GET 需要登录的接口 /api/demo/test2

需要登录的接口

权限

登录	是
鉴权	否

Headers

无

参数

无

正文

无

参数

追加

响应输出

返回参数

无

无

GET 需要登录且需要验证有相应组的权限 /api/demo/test3

需要登录且需要验证有相应组的权限

权限

登录	是
鉴权	是

Headers

无

参数

无

正文

无

参数

追加

响应输出

返回参数

无

无

邮箱验证码接口

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

发送验证码

权限

登录	否
鉴权	否

Headers

无

参数

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

正文

无

参数

追加

event

响应输出

返回参数

无

无

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

检测验证码

权限

登录	否
鉴权	否

Headers

无

参数

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

正文

无

参数

追加

event

captcha

响应输出

返回参数

无

无

首页接口

GET 首页 /api/index/index

首页

权限

登录	否
鉴权	否

Headers

无

参数

无

正文

无

参数

追加

响应输出

返回参数

无

无

GET 搜索 /api/index/search

搜索

权限

登录	是
鉴权	否

Headers

无

参数

名称	类型	必选	描述
min_age	string	是	最小年龄
max_age	string	是	最大年龄
min_height	string	是	最小身高
max_height	string	是	最大身高
region_province	string	是	家乡所在省份id
region_city	string	是	家乡所在市区id
province	string	是	所在城市省份id
city	string	是	所在城市市区id
education	string	是	学历

正文

无

参数

追加

min_age

max_age

min_height

max_height

region_province

region_city

province

city

education

响应输出

返回参数

无

无

POST 搜索内容详情 /api/index/searchDetails

搜索内容详情

权限

登录	是
鉴权	否

Headers

无

参数

名称	类型	必选	描述
nid	string	是	解锁用户id

正文

无

参数

追加

响应输出

返回参数

无

无

POST 解锁进度页 /api/index/unlockProgress

解锁进度页

权限

登录	是
鉴权	否

Headers

无

参数

名称	类型	必选	描述
nid	string	是	解锁用户id
type	string	是	解锁类型1照片2资料3微信

正文

无

参数

追加

nid

type

响应输出

返回参数

无

无

GET 轮播图 /api/index/slideshow

轮播图

权限

登录	否
鉴权	否

Headers

无

参数

无

正文

无

参数

追加

响应输出

返回参数

无

无

GET 首页推荐会员 /api/index/recommend

首页推荐会员

权限

登录	否
鉴权	否

Headers

无

参数

名称	类型	必选	描述
gender	string	是	性别

正文

无

参数

追加

响应输出

返回参数

无

无

POST 会员详情 /api/index/recommendUserDetail

会员详情

权限

登录	是
鉴权	否

Headers

无

参数

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

正文

无

参数

追加

响应输出

返回参数

无

无

POST 喜欢 /api/index/like

喜欢

权限

登录	是
鉴权	否

Headers

无

参数

名称	类型	必选	描述
nid	string	是	喜欢用户id

正文

无

参数

追加

响应输出

返回参数

无

无

POST 解锁微信 /api/index/unlockWx

解锁微信

权限

登录	是
鉴权	否

Headers

无

参数

名称	类型	必选	描述
	name="id",description='解锁用户id'	是

正文

无

参数

追加

响应输出

返回参数

无

无

POST 举报 /api/index/report

权限

登录	是
鉴权	否

Headers

无

参数

名称	类型	必选	描述
nid	string	是	举报用户id
content	string	是	举报内容
image	string	是	举报图片

正文

无

参数

追加

nid

content

image

响应输出

返回参数

无

无

POST 屏蔽 /api/index/shield

屏蔽

权限

登录	是
鉴权	否

Headers

无

参数

名称	类型	必选	描述
type	string	是	1屏蔽
nid	string	是	屏蔽用户id(type为1时传
id	string	是	id(type为2时传

正文

无

参数

追加

type

nid

响应输出

返回参数

无

无

消息

GET 消息 /api/information/index

消息

权限

登录	是
鉴权	否

Headers

无

参数

无

正文

无

参数

追加

响应输出

返回参数

无

无

GET 彼此喜欢 /api/information/eachLike

彼此喜欢

权限

登录	是
鉴权	否

Headers

无

参数

无

正文

无

参数

追加

响应输出

返回参数

无

无

GET 我申请的 /api/information/weApply

我申请的

权限

登录	是
鉴权	否

Headers

无

参数

无

正文

无

参数

追加

响应输出

返回参数

名称	类型	描述
status	string	状态0待同意1已同意2已拒绝3已过期

无

GET 系统通知 /api/information/systemMessages

系统通知

权限

登录	是
鉴权	否

Headers

无

参数

无

正文

无

参数

追加

响应输出

返回参数

无

无

手机短信接口

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

发送验证码

权限

登录	否
鉴权	否

Headers

无

参数

名称	类型	必选	描述
mobile	string	是	手机号
event	string	是	事件名称（mobilelogin登录destruction注销）

正文

无

参数

追加

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

无

参数

无

正文

无

参数

追加

响应输出

返回参数

名称	类型	描述
integrity	string	'个人资料进度'
ilike	string	'我喜欢的'
likeme	string	'喜欢我的'
apply	string	'申请我的'
authentication	string	'认证数量'

无

GET 标签编辑 /api/user/tagedit

标签编辑

权限

登录	是
鉴权	否

Headers

无

参数

名称	类型	必选	描述
tag	string	是	标签id（逗号分割）

正文

无

参数

追加

响应输出

返回参数

无

无

GET 活动列表 /api/user/activity

活动列表

权限

登录	是
鉴权	否

Headers

无

参数

名称	类型	必选	描述
id	string	是	id(获取详情时传

正文

无

参数

追加

响应输出

返回参数

无

无

POST 喜欢额度充值 /api/user/addScore

喜欢额度充值

权限

登录	是
鉴权	否

Headers

无

参数

名称	类型	必选	描述
'score'	string	是	'金额'
'openid'	string	是	'openid'

正文

无

参数

追加

'score'

'openid'

响应输出

返回参数

无

无

POST 狗粮充值 /api/user/addMoney

狗粮充值

权限

登录	是
鉴权	否

Headers

无

参数

名称	类型	必选	描述
'money'	string	是	'金额'
'openid'	string	是	'openid'

正文

无

参数

追加

'money'

'openid'

响应输出

返回参数

无

无

POST 做任务赚狗粮 /api/user/gainMoney

做任务赚狗粮

权限

登录	是
鉴权	否

Headers

无

参数

名称	类型	必选	描述
'type'	string	是	'完善资料，身份认证，学历认证，工作认证，邀请用户注册（领取奖励时传）'

正文

无

参数

追加

响应输出

返回参数

无

无

GET 狗粮明细 /api/user/moneyDetail

狗粮明细

权限

登录	是
鉴权	否

Headers

无

参数

无

正文

无

参数

追加

响应输出

返回参数

无

无

GET 工作认证 /api/user/workAuthentication

工作认证

权限

登录	是
鉴权	否

Headers

无

参数

名称	类型	必选	描述
work	string	是	职业
company_name	string	是	公司名称
authentication_method	string	是	认证方式
image	string	是	照片

正文

无

参数

追加

work

company_name

authentication_method

image

响应输出

返回参数

无

无

GET 学历认证 /api/user/educationAuthentication

学历认证

权限

登录	是
鉴权	否

Headers

无

参数

名称	类型	必选	描述
education	string	是	学历
school	string	是	学校
authentication_method	string	是	认证方式
image	string	是	照片

正文

无

参数

追加

education

school

authentication_method

image

响应输出

返回参数

无

无

GET 身份认证 /api/user/idAuthentication

身份认证

权限

登录	是
鉴权	否

Headers

无

参数

名称	类型	必选	描述
CertName	string	是	真实姓名
CertNo	string	是	证件号码
MetaInfo	string	是
ReturnUrl	string	是

正文

无

参数

追加

CertName

CertNo

MetaInfo

ReturnUrl

响应输出

返回参数

无

无

GET 我的认证状态 /api/user/authentication

我的认证状态

权限

登录	是
鉴权	否

Headers

无

参数

无

正文

无

参数

追加

响应输出

返回参数

无

无

GET 关于我编辑 /api/user/meHowEdit

关于我编辑

权限

登录	是
鉴权	否

Headers

无

参数

名称	类型	必选	描述
mehow	string	是	我的情况
objecthow	string	是	希望对方情况
familyhow	string	是	家庭情况

正文

无

参数

追加

mehow

objecthow

familyhow

响应输出

返回参数

无

无

GET 个性签名编辑 /api/user/signatureEdit

个性签名编辑

权限

登录	是
鉴权	否

Headers

无

参数

名称	类型	必选	描述
signature	string	是	个性签名

正文

无

参数

追加

响应输出

返回参数

无

无

GET 希望对方编辑 /api/user/aboutobject

希望对方编辑

权限

登录	是
鉴权	否

Headers

无

参数

名称	类型	必选	描述
constellation	string	是	星座
min_age	string	是	最小年龄
max_age	string	是	最大年龄
min_height	string	是	最小身高
max_height	string	是	最大身高
education	string	是	学历
car	string	是	车子
house	string	是	房子
marry	string	是	婚史
children	string	是	子女
locality	string	是	本地

正文

无

参数

追加

constellation

min_age

max_age

min_height

max_height

education

car

house

marry

children

locality

响应输出

返回参数

无

无

GET integrity /api/user/integrity

integrity

权限

登录	是
鉴权	否

Headers

无

参数

无

正文

无

参数

追加

响应输出

返回参数

无

无

GET 关于自己编辑 /api/user/aboutuser

关于自己编辑

权限

登录	是
鉴权	否

Headers

无

参数

名称	类型	必选	描述
constellation	string	是	星座
height	string	是	身高
marriage	string	是	婚姻状态
children	string	是	有无子女
marriedtime	string	是	计划结婚
education	string	是	学历
school	string	是	毕业学校
house	string	是	房子
car	string	是	车子
father_work	string	是	父亲工作
mother_work	string	是	母亲工作
brother	string	是	兄弟姐妹
birthday	string	是	生日

正文

无

参数

追加

constellation

height

marriage

children

marriedtime

education

school

house

car

father_work

mother_work

brother

birthday

响应输出

返回参数

无

无

POST 个人资料编辑 /api/user/userinfoedit

个人资料编辑

权限

登录	是
鉴权	否

Headers

无

参数

名称	类型	必选	描述
avatar	string	是	头像
photo	string	是	相册
username	string	是	昵称
province	string	是	所在省份
city	string	是	所在市区
area	string	是	所在区域
work	string	是	工作
max_income	string	是	收入最大值

正文

无

参数

追加

avatar

photo

username

province

city

area

work

max_income

响应输出

返回参数

无

无

POST 基本信息填写 /api/user/userinfo

基本信息填写

权限

登录	是
鉴权	否

Headers

无

参数

名称	类型	必选	描述
gender	string	是	性别
marriage	string	是	婚姻状态
birthday	string	是	生日
height	string	是	身高
education	string	是	学历id
school	string	是	毕业学校
work	string	是	工作
max_income	string	是	收入
region_province	string	是	家乡所在省份
region_city	string	是	家乡所在市区
region_area	string	是	家乡所在区域
futurehometown	string	是	未来定居城市
marriedtime	string	是	计划结婚id
objecteducation	string	是	ta的学历id
min_age	string	是	ta的年龄最小值
max_age	string	是	ta的年龄最大值
min_height	string	是	ta的身高最小值
max_height	string	是	ta的身高最大值
wx	string	是	微信号码
image	string	是	图片

正文

无

参数

追加

gender

marriage

birthday

height

education

school

work

max_income

region_province

region_city

region_area

futurehometown

marriedtime

objecteducation

min_age

max_age

min_height

max_height

image

响应输出

返回参数

无

无

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

修改手机号

权限

登录	否
鉴权	否

Headers

无

参数

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

正文

无

参数

追加

mobile

captcha

响应输出

返回参数

无

无

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

修改会员个人信息

权限

登录	是
鉴权	否

Headers

无

参数

名称	类型	必选	描述
avatar	string	是	头像地址
username	string	是	用户名
nickname	string	是	昵称
bio	string	是	个人简介

正文

无

参数

追加

avatar

username

nickname

bio

响应输出

返回参数

无

无

POST 退出登录 /api/user/logout

退出登录

权限

登录	是
鉴权	否

Headers

无

参数

无

正文

无

参数

追加

响应输出

返回参数

无

无

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

手机验证码登录

权限

登录	否
鉴权	否

Headers

无

参数

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

正文

无

参数

追加

mobile

captcha

code

响应输出

返回参数

无

无

POST 会员登录 /api/user/login

会员登录

权限

登录	否
鉴权	否

Headers

无

参数

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

正文

无

参数

追加

account

password

响应输出

返回参数

无

无

GET 申请我的操作 /api/user/applyop

申请我的操作

权限

登录	是
鉴权	否

Headers

无

参数

名称	类型	必选	描述
id	string	是	id
type	string	是	1同意2拒绝

正文

无

参数

追加

type

响应输出

返回参数

无

无

POST 我喜欢的/喜欢我的/申请我的/看了我的列表 /api/user/dynamic

我喜欢的/喜欢我的/申请我的/看了我的列表

权限

登录	是
鉴权	否

Headers

无

参数

名称	类型	必选	描述
type	string	是	1我喜欢的 2喜欢我的 3申请我的 4看了我的

正文

无

参数

追加

响应输出

返回参数

无

无

GET count_ /api/user/count_

count_

权限

登录	是
鉴权	否

Headers

无

参数

无

正文

无

参数

追加

响应输出

返回参数

无

无

POST 注销操作 /api/user/reasonCancellation

注销操作

权限

登录	是
鉴权	否

Headers

无

参数

名称	类型	必选	描述
'code'	string	是	'验证码'
'reason_cancellation'	string	是	'注销原因'

正文

无

参数

追加

'code'

'reason_cancellation'

响应输出

返回参数

无

无

验证接口

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

响应输出

返回参数

无

无