跳到主要内容

GAS 自动登录接口

基本信息​

接口描述： 验证用户登录状态，兼容新老版本登录方式。

接口地址： https://api.chinadlrs.com/developer/auto-login.php

请求方式： POST

响应格式： JSON

需要开放授权登录

此接口功能基于开放授权登录，所有操作都需要先获取有效的 access_token （或老版本登录接口的 user_token）
具体的获取流程请参考《GAS 开放授权登录接口说明文档》

请求参数​

请求头 (Headers)​

参数名类型必填描述
Content-Typestring是必须设置为 application/json

查询参数 (Query Parameters)​

参数名类型必填描述默认值
langstring否响应语言（zh/en）zh
查询参数

查询参数通过在接口地址后直接拼接的方式传递，地址和参数之间用 ? 分隔，多个参数之间用 & 连接。

例如响应语言为英文的接口地址为：
https://api.chinadlrs.com/developer/auto-login.php?lang=en

请求体 (Body)​

参数名类型必填描述示例
appidint是应用唯一标识符1
emailstring是用户邮箱地址"user@example.com"
user_tokenstring条件必填老版本用户令牌（与access_token二选一）"加密字符串"
access_tokenstring条件必填新版本访问令牌（与user_token二选一）"加密字符串"
参数说明

user_token 和 access_token 参数必须二选一，不能同时提供也不能都不提供

数据加密

user_token 和 access_token 参数是经过加密的字符串，用于验证应用权限和保护数据安全
具体的加密算法请参考《数据加密说明文档》

请求示例​

{
  "appid": 1,
  "email": "user@example.com",
  "user_token": "BKaX5H0VOb0L"
}

或

{
  "appid": 1,
  "email": "user@example.com", 
  "access_token": "027Mb1LyaAWtpOIC"
}

响应参数​

响应参数表

参数名类型描述示例
codenumber状态码200
dataobject数据对象（在此接口中始终为null）null
msgstring响应消息"操作成功"

成功响应示例

{
  "code": 200,
  "data": null,
  "msg": "操作成功"
}

错误响应示例

{
  "code": 401,
  "data": null, 
  "msg": "登录已失效"
}

状态码说明​

状态码描述解决方案
200操作成功，登录状态有效
400请求参数缺失检查 appid 和 email 参数是否提供
400参数格式错误检查 user_token 和 access_token 参数是否符合规则（二选一）
404应用不存在验证 appid 是否正确
401Token验证失败检查 token 是否正确
401登录已失效重新登录获取新的 token