DingraiaPHP开发者

开发者上一步得到的上一步得到的获取token

使用钉钉OAuth2登录

快速登录页面

xyAPP获取token

获取登录请求代码

GET https://api.lxyddice.top/dingbot/php/?action=api&type=xyAppGetState

Response

200

{
    "success": true,
    "code": 0,
    "message": "API调用成功了喵~",
    "result": {
        "state": "5c5a3ff9-52bd-c49b-b05f-1bca6273fcd0",
        "timeStamp": 1714488342
    },
    "request_id": "1714488342_ae67ae84-b6ad-a09a-a6cb-336f1d1fc32f"
}

403

{
    "success": false,
    "code": -5,
    "message": "冰晶拒绝大人的请求(//̀Д/́/)",
    "result": null,
    "request_id": "1714491128_b77f858a-1fc0-d9a8-4f62-977f813fec4a",
    "tips": "IP xx.xx.xx.xxx 已存在登录请求，请使用 type=xyAppClearIpState 取消"
}

清除登录请求代码

GET https://api.lxyddice.top/dingbot/php/?action=api&type=xyAppClearIpState

Response

200

{
    "success": true,
    "code": 0,
    "message": "API调用成功了喵~",
    "result": {
        "state": "5c5a3ff9-52bd-c49b-b05f-1bca6273fcd0",
        "createAt": 1714488342,
        "timeStampe": 1714491351
    },
    "request_id": "1714491351_a327e328-3b48-ee06-800f-f64142fdd00a"
}

404

{
    "success": false,
    "code": -6,
    "message": "（翻找）没...没找到诶？TAT",
    "result": null,
    "request_id": "1714491462_8b9c557f-c299-3194-0d97-acec865c4450",
    "tips": "IP xx.xx.xx.xxx 不存在登录请求"
}

获取钉钉登录的跳转地址

GET https://api.lxyddice.top/dingbot/php/?action=api&type=xyAppLoginWithDingtalkOAuth2

Params

Name	Type	Description
state	string	得到的登录请求代码

Response

200

{
    "success": true,
    "code": 0,
    "message": "API调用成功了喵~",
    "result": {
        "state": "a95bb8c2-b084-869c-d76f-52ba5da21309",
        "createAt": 1723393731,
        "timeStampe": 1723393732,
        "urlId": "ANVpQjLH"
    },
    "request_id": "1723393732_46e5bcdd-908c-e23c-298f-04bbf8e25a2d",
    "apiPath": "xyAppLoginWithDingtalkOAuth2"
}

404

{
    "success": false,
    "code": -5,
    "message": "冰晶拒绝大人的请求(//̀Д/́/)",
    "result": null,
    "request_id": "1714491585_710721ef-04ee-7d06-d6be-dc3cdb47e1f0",
    "tips": "不存在登录请求 State:d1a906af-2ee0-f51d-6ada-6d1e11de1e44"
}

获取钉钉登录的跳转地址

GET https://api.lxyddice.top/dingbot/php/?action=api&type=getShortUrlInfo

Params

Name	Type	Description
id	string	urlId 短链接代码

Response

200

{
    "success": true,
    "code": 0,
    "message": "API调用成功了喵~",
    "result": {
        "url": "http://api.lxyddice.top/dingbot/php/?client_id=xxxxx"
    },
    "request_id": "1723393746_5a1e2650-b635-7272-5983-d60f2292c8ae",
    "apiPath": "getShortUrlInfo"
}

404

{
    "success": false,
    "code": -6,
    "message": "（翻找）没...没找到诶？TAT",
    "result": null,
    "request_id": "1723393846_b1fd2cb2-034b-5b09-aee6-fc5c36d6fe6f",
    "apiPath": "getShortUrlInfo"
}

完成登录

登录成功得到token

{
    "success": true,
    "code": 0,
    "message": "API调用成功了喵~",
    "result": {
        "token": "abcdefghijklmnopqrstuvwxyz",
        "expiration": 1714497275,
        "unionId": "xxx"
    },
    "request_id": "1714490072_fe3fc718-fd61-6564-dfc2-000d309a0a59"
}

登录成功但无权限

{
    "success": false,
    "code": -5,
    "message": "冰晶拒绝大人的请求(//̀Д/́/)",
    "result": null,
    "request_id": "1714491720_5776f845-6c59-546d-02c6-5666a051c5fc",
    "tips": "很遗憾，您似乎不具备钉钉登录获取开发者token的权限~ unionId:xxx"
}

验证token可用性

GET https://api.lxyddice.top/dingbot/php/?action=api&type=xyAppCheckToken

Params

Name	Type	Description
token	String	上面得到的token

Response

200

{
    "success": true,
    "code": 0,
    "message": "API调用成功了喵~",
    "result": {
        "unionId": "xxx",
        "expiration": 1714497275
    },
    "request_id": "1714490762_6d9a20b5-cc20-77e9-5117-7968b68ba80e"
}

403

{
    "success": false,
    "code": -5,
    "message": "冰晶拒绝大人的请求(//̀Д/́/)",
    "result": null,
    "request_id": "1714491964_a8a0d13f-f4bd-0e2e-0f99-663dc6fe2977"
}

创建APP以便获取id和密钥

GET https://api.lxyddice.top/dingbot/php/?action=api&type=xyAppGetId

Body

Name	Type	Description
token	string	AccessToken

Response

200

{
    "success": true,
    "code": 0,
    "message": "API调用成功了喵~",
    "result": [
        {
            "appId": "xxx",
            "appSecret": "xxxxxxxx"
        }
    ],
    "request_id": "1714633692_76398e1c-5f8e-7c35-9b00-c0ef41df64dd",
    "apiPath": "xyAppGetId"
}

403

{
    "success": false,
    "code": -5,
    "message": "冰晶拒绝大人的请求(//̀Д/́/)",
    "result": null,
    "request_id": "1714714263_8c358e28-3c93-4acf-32aa-70d561ae242f",
    "apiPath": "xyAppGetId"
}

使用APPID和APPSECRET获取TOKEN

GET https://api.lxyddice.top/dingbot/php/?action=api&type=xyAppGetAccessToken

Params

Name	Type	Description
appId	string	appId
appSecret	string	appSecret

Response

200

{
    "success": true,
    "code": 0,
    "message": "API调用成功了喵~",
    "result": {
        "token": "xxxxxxxxxxxxxxxxxxx",
        "expiration": 1714645804,
        "unionId": "xxxxx"
    },
    "request_id": "1714638604_123f7afb-409d-55d9-4059-27a70dfc408f",
    "apiPath": "xyAppGetAccessToken"
}

403

{
    "success": false,
    "code": -5,
    "message": "冰晶拒绝大人的请求(//̀Д/́/)",
    "result": null,
    "request_id": "1714714489_02bef3e2-f000-32bd-d8b0-c91481ee0c71",
    "apiPath": "xyAppGetAccessToken"
}

404

{
    "success": false,
    "code": -6,
    "message": "（翻找）没...没找到诶？TAT",
    "result": null,
    "request_id": "1714714496_ec9e6def-f66d-fdef-2349-78665396b2d7",
    "apiPath": "xyAppGetAccessToken"
}