mirai/mirai-api-http
2020-02-19 21:07:39 +08:00
..
src/main/kotlin/net/mamoe/mirai/api/http Merge remote-tracking branch 'origin/master' 2020-02-19 21:07:39 +08:00
build.gradle.kts base framework 2020-02-04 17:51:51 +08:00
README_CH.md http api support Face 2020-02-19 21:07:12 +08:00
README.md readme of HTTP 2019-12-17 11:02:45 +08:00

mirai-api-http

Mirai-API-http provides adapter for ALL langugae to access mirai via HTTP protocol.

中文

Start Session-Authorize

Path: /auth
Method: POST

this verify your session to one bot and you could have full access to that bot
NOTE that only 1 bot could be control under 1 session, you could have multiple session to control all bots.

Request:

name type optional example note
key String false U9HSaDXl39ksd918273hU MIRAI API HTTP key, this could be found after initialize
qq String false 1040400290 bot QQ number you want to access

Response if success:

name type example note
success Boolean true if this session is authorized
session String UANSHDKSLAOISN your session key

Response if failed:

name type example note
success Boolean false if this session is authorized
session String null your session key
error int 0 error code

Error:

code reason
0 wrong MIRAI API HTTP key
1 unknown bot number

without session key, you are not able to access any method below.
session key should be attached to your cookies like this:

name value
session your session key here

if you were getting HTTP error code 403, you should ask for a new session key.