mirai/mirai-api-http/README.md

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.