# api-v1 🔧

## 获取当前访问IP地址

<mark style="color:blue;">`GET`</mark> `https://api.nullcraft.org/v1/tools/ip`

获取访问者IP，主要用于开服器IP获取

#### Query Parameters

| Name | Type   | Description       |
| ---- | ------ | ----------------- |
| type | string | 可选:json 默认直接返回字符串 |

{% tabs %}
{% tab title="200 返回结果" %}
{% tabs %}
{% tab title="无参数直接访问" %}

```javascript
返回访问者IP
```

{% endtab %}

{% tab title="JSON" %}
{% code title="//使用 type=json 参数访问结果" %}

```javascript
{
  "code": 200,
  "ip": "访问者IP"
}
```

{% endcode %}
{% endtab %}
{% endtabs %}
{% endtab %}
{% endtabs %}

## 获取Minecraft官方服务端信息

<mark style="color:blue;">`GET`</mark> `https://api.nullcraft.org/v1/minecraft/server/:version`

获取版本服务端信息，仅原版官方端

#### Path Parameters

| Name    | Type   | Description                                   |
| ------- | ------ | --------------------------------------------- |
| version | string | \[可选] 不填默认返回全部列表，Minecraft版本名称如:1.16.5、21w03a |

{% tabs %}
{% tab title="200 返回服务端信息" %}

```javascript
{
  "version": "1.16.5",
  "sha1": "1b557e7b033b583cd9f66746b7a9ab1ec1673ced",
  "size": 37962360,
  "url": "https://launcher.mojang.com/v1/objects/1b557e7b033b583cd9f66746b7a9ab1ec1673ced/server.jar"
}
```

{% endtab %}
{% endtabs %}

## &#x20;生成Mojang快照风格版本号

<mark style="color:blue;">`GET`</mark> `https://api.nullcraft.org/v1/tools/week`

返回JSON格式

{% tabs %}
{% tab title="200 " %}

```
{
  "year": "21",
  "week": 36,
  "snapshot": "21w36a"
}
```

{% endtab %}
{% endtabs %}