mirai/mirai-api-http
liujiahua123123 25af15e0ed http
2019-12-15 17:15:25 +08:00
..
src/main/kotlin/net.mamoe.mirai.api.http Change Bot to interface, implement Bot as BotImpl, fix #20 2019-12-14 23:38:56 +08:00
build.gradle.kts Simplify build.gradle 2019-12-02 17:57:14 +08:00
README.md http 2019-12-15 17:15:25 +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.