Release v1.0.3

Author: stdrc

docs/API.md

@@ -28,14 +28,28 @@ Authorization: token kSLuTF2GC2Q4q4ugm3
 ```json
 {
     "status": "ok",
+    "retcode": 0,
     "data": {
         "id": 123456,
         "nickname": "滑稽"
     }
 }
 ```
 
-`status` 字段如果是 `ok` 则表示 API 存在、参数有效，并且已经调用了酷 Q 的对应函数，但由于酷 Q 的函数并没有明显的成功与否的反馈，不能确定是否真的操作成功（例如，如果传入的 QQ 号不是好友，实际上是无法成功发送消息的）；如果是 `failed` 则表示 API 不存在，或参数不正确。
+~~`status` 字段如果是 `ok` 则表示 API 存在、参数有效，并且已经调用了酷 Q 的对应函数，但由于酷 Q 的函数并没有明显的成功与否的反馈，不能确定是否真的操作成功（例如，如果传入的 QQ 号不是好友，实际上是无法成功发送消息的）；如果是 `failed` 则表示 API 不存在，或参数不正确。~~
+
+`status` 字段如果是 `ok` 则表示操作成功，同时 `retcode` （返回码）会等于 0，即酷 Q 函数返回了 0，也就是酷 Q 认为成功了，但实际上有某些情况下其实是没有成功的，比如向没有加入的群发送消息，返回码是 0，日志里也没有提示发送失败，但显然是发送不了的。这一点在酷 Q 的 [官方文档](https://d.cqp.me/Pro/%E5%BC%80%E5%8F%91/Error) 也说明了：
+
+>  需要指出的是，某些接口暂未进行错误代码的处理，此时即使发生错误，仍返回0。
+
+`status` 字段如果是 `failed` 则表示操作失败，此时 `retcode` 有两种情况，当大于 0 时，表示是 HTTP API 插件判断出的失败（此时根本不用调用酷 Q 的函数就可以确定操作失败，比如调用 API 时没有传入必须的字段），这个目前有如下情况：
+
+| 返回码  | 说明                                       |
+| ---- | ---------------------------------------- |
+| 100  | 默认的错误码，通常是因为没有传入必要参数，某些接口中也可能因为参数明显无效，比如传入的 QQ 号小于等于 0 |
+| 101  | 调用的接口路径不存在                               |
+
+另外一种情况是 `retcode` 小于 0，此时即为调用酷 Q 函数的返回码，具体含义直接参考 [Pro/开发/Error](https://d.cqp.me/Pro/%E5%BC%80%E5%8F%91/Error)。
 
 `data` 字段为 API 返回数据的内容，对于发送消息、踢人等不需要返回数据的操作，这里为 null，对于获取群成员信息这类操作，这里为所获取的数据的对象，具体的数据内容将会在相应的 API 描述中给出。
 

io.github.richardchien.coolqhttpapi.json

@@ -5,8 +5,8 @@
     "ret": 1, // 返回码，固定为1
     "apiver": 9, // Api版本，本SDK为9
     "name": "HTTP API", // 应用名称
-    "version": "1.0.2", // 应用版本
-    "version_id": 6, // 应用顺序版本（每次发布时至少+1）
+    "version": "1.0.3", // 应用版本
+    "version_id": 7, // 应用顺序版本（每次发布时至少+1）
     "author": "Richard Chien", // 应用作者
     "description": "使酷 Q 支持通过 HTTP 上报事件信息及调用接口",
     "event": [ // 事件列表，同一事件类型可重复定义（发布前请删除无用事件）

src/misc_functions.h

@@ -8,7 +8,7 @@ size_t curl_write_stringstream_callback(char* buf, size_t size, size_t nmemb, st
 
 size_t curl_write_file_callback(char* buf, size_t size, size_t nmemb, FILE* fp);
 
-bool isnumber(const std::string& s);
+bool isnumber(const std::string& s); // act as "is_positive_integer", actually
 
 std::string itos(int64_t i);
 

src/request.cpp

@@ -164,7 +164,7 @@ int64_t cqhttp_get_integer_param(const struct cqhttp_request& request, const cha
     if (str)
     {
         if (isnumber(str))
-            result = atol(str);
+            result = stoll(str);
         free(str);
     }
     else