diff --git a/mirai-api-http/README.md b/mirai-api-http/README.md
index cfc22b29c..139b3bf06 100644
--- a/mirai-api-http/README.md
+++ b/mirai-api-http/README.md
@@ -5,7 +5,7 @@ Mirai-API-http provides adapter for ALL langugae to access mirai via HTTP protoc
-#### Start Session-Authorize
+### Start Session-Authorize
```php
Path: /auth
@@ -14,11 +14,43 @@ 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|this could be found after initialize|
+| 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:
-
\ No newline at end of file
+ | name | value |
+ | --- | --- |
+ | session |your session key here |
+
+ if you were getting HTTP error code 403, you should ask for a new session key.
\ No newline at end of file