返回首页

示例接口

公开接口免费

一个简单的示例接口，返回Hello World信息，演示API系统的基本功能

请求信息

请求方式 GET

返回格式 JSON

请求地址

https://api.microku.cn/api/test.php

示例地址

/api/test.php?key=YOUR_API_KEY&name=John

请求参数

参数名	类型	必填	说明
name	string	否	你的名字，默认为World

返回参数

字段名	类型	说明
code	integer	状态码
msg	string	状态消息
data.message	string	返回消息内容
timestamp	integer	时间戳

状态码说明

状态码	状态信息	说明
200	OK	请求成功
400	Bad Request	请求参数错误
401	Unauthorized	未授权，无效的API密钥
403	Forbidden	权限不足或余额不足
404	Not Found	接口不存在
429	Too Many Requests	请求过于频繁
500	Internal Server Error	服务器内部错误
502	Bad Gateway	网关错误

在线测试

点击"发送请求"按钮查看返回结果...

调用示例

PHP (cURL)

<?php
$url = 'https://api.microku.cn/api/test.php';
$params = [
    'name' => 'value',
];

$url .= '?' . http_build_query($params);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
print_r($data);

Python (requests)

import requests

url = "https://api.microku.cn/api/test.php"
params = {
    "name": "value",
}

response = requests.get(url, params=params, verify=False)
print(response.text)

JavaScript (fetch)

const url = new URL("https://api.microku.cn/api/test.php");
const params = {
    "name": "value",
};

Object.keys(params).forEach(key =>
    url.searchParams.append(key, params[key])
);

fetch(url)
    .then(response => response.json())
    .then(data => console.log(data))
    .catch(error => console.error("Error:", error));

cURL

curl -X GET "https://api.microku.cn/api/test.php?name=value" \
  -H "Accept: application/json"

Java (HttpClient)

import java.net.URI;
import java.net.http.*;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;

public class ApiTest {
    public static void main(String[] args) throws Exception {
        String url = "https://api.microku.cn/api/test.php";

        StringBuilder params = new StringBuilder();
        params.append("name=")
              .append(URLEncoder.encode("value", StandardCharsets.UTF_8));

        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create(url + "?" + params.toString()))
            .GET()
            .build();

        HttpResponse<String> response = client.send(request,
            HttpResponse.BodyHandlers.ofString());

        System.out.println(response.body());
    }
}

Go (net/http)

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
)

func main() {
    baseURL := "https://api.microku.cn/api/test.php"

    params := url.Values{}
    params.Add("name", "value")

    fullURL := baseURL + "?" + params.Encode()

    resp, err := http.Get(fullURL)
    if err != nil {
        fmt.Println("Error:", err)
        return
    }
    defer resp.Body.Close()

    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

Ruby (net/http)

require 'net/http'
require 'uri'

url = URI("https://api.microku.cn/api/test.php")

params = {
    "name" => "value",
}

url.query = URI.encode_www_form(params)

response = Net::HTTP.get_response(url)
puts response.body if response.is_a?(Net::HTTPSuccess)

C# (HttpClient)

using System;
using System.Net.Http;
using System.Threading.Tasks;
using System.Web;

class Program
{
    static async Task Main()
    {
        string url = "https://api.microku.cn/api/test.php";

        var query = HttpUtility.ParseQueryString(string.Empty);
        query["name"] = "value";

        string fullUrl = url + "?" + query.ToString();

        using (HttpClient client = new HttpClient())
        {
            HttpResponseMessage response = await client.GetAsync(fullUrl);
            string result = await response.Content.ReadAsStringAsync();
            Console.WriteLine(result);
        }
    }
}