OneBotApiResult
data class OneBotApiResult<T : Any>(val retcode: Int, val status: String? = null, val data: T? = null)(source)
OneBot 会对每个 API 调用返回一个 JSON 响应(除非是 HTTP 状态码不为 200 的情况),响应中的 data
字段包含 API 调用返回的数据内容。 在后面的 API 描述中,将只给出 data
字段的内容,放在「响应数据」小标题下,而不再赘述 status
、retcode
字段。
在 OneBotApiResult 中,为了区分失败的结果和成功但结果为 null
的情况, 那个本身成功结果就应该为 null
的 API 应当将结果 T 定义为 Unit 类型以此代替 null
。 同时在反序列化时,如果 retcode
== RETCODE_SUCCESS 并且结果的预期类型是一个 Unit,则直接填充它。 建议