HTTP/HTTPS
请求协议
赤那接口平台 / Zny\ / [账号登录]
[账号登录]
接口地址：https://cnapi.shuidiwang.cn/api/app.php?s=Zny.User.Login
接口描述： 账号登录
接口参数
| 参数名字 | 类型 | 是否必须 | 默认值 | 其他 | 说明 |
|---|---|---|---|---|---|
| access_token | 字符串 | 可选 | 访问令牌，仅当开启签名验证时需要传递，生成令牌可使用App.Auth.ApplyToken接口 | ||
| phone | 字符串 | 必须 | - | 账号 | |
| pwd | 字符串 | 必须 | 1 | 最小：6 | 用户密码(以字母开头，长度在6~18之间，只能包含字母、数字和下划线) |
| type | 枚举类型 | 必须 | 1 | 范围：1/2/3/4/5 | 操作方式(1.网站|2.安卓|3.IOS|4.小程序|5.公众号) |
| ip | 字符串 | 必须 | - | IP | |
| mark | 枚举类型 | 必须 | 1 | 范围：1/2 | 标识（1.账号密码登录|2.验证码登录） |
| remark | 字符串 | 可选 | 备注 | ||
| application_id | 整型 | 必须 | - | 应用ID |
返回字段
| 返回结果 | 类型 | 说明 |
|---|---|---|
| ret | 整型 | 状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务器错误 |
| data | 对象或混合类型 | 业务数据，由各自接口指定，通常为对象 |
| data.id | 整型 | 用户ID |
| data.number | 字符串 | 通知编号 |
| data.login_phone | 字符串 | 登陆手机号码(或账号) |
| data.weixin_phone | 字符串 | 微信手机号码 |
| data.reg_ip | 字符串 | 注册IP |
| data.reg_time | time | 注册时间 |
| data.safety_email | 字符串 | 安全邮箱 |
| data.status | 整型 | 状态（1开启 | 2.关闭） |
| data.phone_certification_status | 整型 | 手机号码是否实名认证（1.以实名，2.未实名） |
| data.province | 字符串 | 省 |
| data.city | 字符串 | 市 |
| data.district | 字符串 | 区县 |
| data.address | 字符串 | 所在地址 |
| data.is_admin | 整型 | 是否是管理员（1是，2否） |
| data.is_blacklist | 整型 | 是否是黑名单（1是，2否） |
| data.is_obtain_phone | 整型 | 是否允许获取手机号(1.是|2.否) |
| data.review_status | 整型 | 审核状态（1.未提交|2.已提交|3.审核未通过|4.已审核） |
| data.address_id | 整型 | 默认收货地址 |
| data.login_time | time | 最新登录时间 |
| data.source | 字符串 | 注册来源（项目首字母-小程序版本）|（小程序版本（android版本(android)|ios版本(ios)|H5版本（h5）|微信版本（wx）|支付宝小程序（zfb）|百度小程序（bd）|头条小程序（tt）|QQ小程序（qq））） |
| data.分割线 | ------- | --------- |
| data.extend_id | 整型 | 记录扩展信息ID |
| data.real_name | 字符串 | 真实姓名 |
| data.nickname | 字符串 | 用户昵称 |
| data.head | 字符串 | 头像 |
| data.sex | 整型 | 性别(1男 | 2女) |
| data.birth | time | 生日 |
| data.qq | 字符串 | |
| data.credits | 整型 | 积分 |
| data.exp | 整型 | 经验值 |
| data.birth_phase | 字符串 | 属相 |
| data.constellation | 字符串 | 星座 |
| data.political_status | 字符串 | 政治面貌 |
| data.education | 字符串 | 学历 |
| data.nation | 字符串 | 民族 |
| data.native | 字符串 | 籍贯 |
| data.marital | 字符串 | 婚姻状态 |
| data.latitude | 字符串 | 用户当前位置-纬度 |
| data.longitudu | 字符串 | 用户当前位置-经度 |
| data.role_id | 整型 | 角色ID |
| msg | 字符串 | 提示信息，失败时的错误提示 |
在线测试
| 参数 | 是否必须 | 值 |
|---|---|---|
| service | 必须 | |
| access_token | 可选 | |
| phone | 必须 | |
| pwd | 必须 | |
| type | 必须 | |
| ip | 必须 | |
| mark | 必须 | |
| remark | 可选 | |
| application_id | 必须 |
客户端请求示例
# 暂无示例，可添加示例文件：./src/view/docs/demos/Zny.User.Login.json错误列表
| 错误状态码 | 错误描述信息 |
|---|---|
| 400 | ret=400，客户端参数错误或非法请求 |
| 404 | 表示接口服务不存在 |
| 406 | ret=406，access_token令牌校验不通过 |
| 407 | ret=407，app_key权限不足，或未知应用 |
| 408 | ret=408，当前用户禁止使用，或用户未登录 |
| 500 | 表示服务端内部错误 |
本文档生成时间：2026-01-24 23:19:22