MCBE服务器信息查询文档

API文档
状态码参照
代码示例

接口地址： https://api.hotaru.icu/api/motdpe

返回类型： application/json

请求方式： GET/POST

请求示例： https://api.hotaru.icu/api/motdpe?ip=82.157.165.201&port=19111

请求参数说明：

名称	必填	类型	说明
ip	是	string	服务器IP地址
port	是	number	服务器端口

返回参数说明：

名称	类型	说明
status	string	状态(在线,离线)
ip	string	IP或域名
real	string	IP
port	number	端口
location	string	地址
motd	string	服务器提示信息
agreement	number	服务器协议版本
version	string	服务器版本
online	number	服务器在线人数
max	number	服务器最大人数
gamemode	string	服务器游戏模式
delay	number	delay

返回示例：

{
    "code": 500,
    "message": "success",
    "data": {
        "status": "online",
        "ip": "cloud.huliapi.xyz",
        "real": "82.157.165.201",
        "port": 20101,
        "location": "安徽省阜阳市 联通",
        "motd": "CHED Server",
        "agreement": 554,
        "version": "1.19.31",
        "online": 0,
        "max": 10000,
        "gamemode": "Survival",
        "delay": 40
    }
}

状态码说明：

名称	说明
500	请求成功
501	错误
502	错误
503	错误

调用示例：

PHP:
<?php
$result = file_get_contents("https://api.hotaru.icu/api/motdpe?ip=82.157.165.201&port=19111");
var_dump($result);
?>

JavaScript:
const url = "https://api.hotaru.icu/api/motdpe?ip=82.157.165.201&port=19111";
fetch(url)
  .then(res => res.json)
  .(res => {
    console.log(res);
  });

Python:
import requests

url="https://api.hotaru.icu/api/motdpe?ip=82.157.165.201&port=19111"
payload={}
r = requests.get(url,params=payload)
print(r);

lua:
local httputil = HttpUtil()
local url = "https://api.hotaru.icu/api/motdpe?ip=82.157.165.201&port=19111"
local resStr
local res,code = httputil.httpPost(url,str)
    if code ~= 200 then
        ngx.log(ngx.WARN,"code:"..code)
            return resStr
    end
resStr = res

C/C++:
#include <iostream>  
#include <string>  
#include "curl/curl.h"  
using namespace std;  

#pragma comment(lib, "ws2_32.lib")  
#pragma comment(lib, "wldap32.lib")  
#pragma comment(lib, "libcurl.lib")  

size_t req_reply(void *ptr, size_t size, size_t nmemb, void *stream)  
{  
    cout << "----->reply" << endl;  
    string *str = (string*)stream;  
    cout << *str << endl;  
    (*str).append((char*)ptr, size*nmemb);  
    return size * nmemb;  
}  

CURLcode curl_get_req(const std::string &url, std::string &response)  
{  
    CURL *curl = curl_easy_init();  
    CURLcode res;  
    if (curl)  
    {  
        curl_easy_setopt(curl, CURLOPT_URL, url.c_str());
        curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, false);
        curl_easy_setopt(curl, CURLOPT_SSL_VERIFYHOST, false);
        curl_easy_setopt(curl, CURLOPT_VERBOSE, 1);  
        curl_easy_setopt(curl, CURLOPT_READFUNCTION, NULL);  
        curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, req_reply);  
        curl_easy_setopt(curl, CURLOPT_WRITEDATA, (void *)&response);  
        curl_easy_setopt(curl, CURLOPT_NOSIGNAL, 1);  
        curl_easy_setopt(curl, CURLOPT_HEADER, 1);  
        curl_easy_setopt(curl, CURLOPT_CONNECTTIMEOUT, 3);
        curl_easy_setopt(curl, CURLOPT_TIMEOUT, 3);  
        res = curl_easy_perform(curl);  
    }  
    curl_easy_cleanup(curl);  
    return res;  
}  


int main()  
{  
    curl_global_init(CURL_GLOBAL_ALL);  

    string getUrlStr = "https://api.hotaru.icu/api/motdpe?ip=82.157.165.201&port=19111";  
    string getResponseStr;  
    auto res = curl_get_req(getUrlStr, getResponseStr);  
    if (res != CURLE_OK)  
        cerr << "curl_easy_perform() failed: " + string(curl_easy_strerror(res)) << endl;  
    else  
        cout << getResponseStr << endl;  

    curl_global_cleanup();  
    system("pause");  
    return 0;  
}  

Java:
package com.jl.chromeTest;

import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
import java.net.URLConnection;
import java.nio.charset.StandardCharsets;

public class Test {

    @org.junit.Test
    public void test() throws Exception{
        String result = get("https://api.hotaru.icu/api/motdpe?ip=82.157.165.201&port=19111");
        System.out.println("result====="+result);
    }
    
    public  String get(String url) throws Exception {
        String content = null;
        URLConnection urlConnection = new URL(url).openConnection();
        HttpURLConnection connection = (HttpURLConnection) urlConnection;
        connection.setRequestMethod("GET");
        connection.connect();
        int responseCode = connection.getResponseCode();
        if (responseCode == HttpURLConnection.HTTP_OK) {
            BufferedReader bufferedReader = new BufferedReader(new InputStreamReader
                (connection.getInputStream(), StandardCharsets.UTF_8));
            StringBuilder bs = new StringBuilder();
            String l;
            while ((l = bufferedReader.readLine()) != null) {
                bs.append(l).append("\n");
            }
            content = bs.toString();
        }
        return content;
    }
}

CS:
HttpWebRequest request = (HttpWebRequest)WebRequest.Create("https://api.hotaru.icu/api/motdpe?ip=82.157.165.201&port=19111");
HttpWebResponse response = (HttpWebResponse)request.GetResponse();
String result = new StreamReader(response.GetResponseStream()).ReadToEnd();

Golang:
func httpGet() {
    resp, err :=   http.Get("https://api.hotaru.icu/api/motdpe?ip=82.157.165.201&port=19111")
    if err != nil {
    }

    defer resp.Body.Close()
    body, err := ioutil.ReadAll(resp.Body)
    if err != nil {
    }

    fmt.Println(string(body))
}


EPL:
.版本 2

.局部变量 待返回, 文本型

待返回 ＝ 编码_utf8到gb2312 (到文本 (网页_访问_对象 (“https://api.hotaru.icu/api/motdpe?ip=82.157.165.201&port=19111”)))

HotaruAPI

The purpose is to provide stable and fast API interface and no bug