[API] 获取客户端公网 IPv4 地址

1.接口描述

该接口用于网络排障,请在中国法律许可范围内使用.

接口地址: https://ipv4.ipw.cn/api/ip/myip

请求方法:GET

用途:返回客户端公网IP

频率限制:暂无,详见压测报告

2. 输入参数

3. 输出参数

参数名称类型描述
String客户端公网IP

4. 示例

4.1 cURL 获取本机公网IPv4 地址

输入示例

curl ipw.cn/api/ip/myip
1

通过命令行可以简写:

curl ipw.cn

curl ipw.cn/myip

输出示例

106.224.145.147
1

4.2 Python 获取本机公网IPv4地址

  • 输入示例
#!/usr/bin/python3

import requests

# 获取 IPv6 地址接口; https://ipv6.ipw.cn/api/ip/myip
r = requests.get('https://ipv4.ipw.cn/api/ip/myip')

clientIP = r.text

print(clientIP)
1
2
3
4
5
6
7
8
9
10
  • 输出示例
106.224.145.147
1

4.3 Golang 获取本机公网IP

  • 输入示例
package main

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

func main() {

    // 获取 IPv6 地址接口; https://ipv6.ipw.cn/api/ip/myip
	responseClient, errClient := http.Get("https://ipv4.ipw.cn/api/ip/myip")

	if errClient != nil {
		fmt.Printf("获取外网 IP 失败,请检查网络\n")
		panic(errClient)
	}
	defer responseClient.Body.Close()

	// 获取 http response 的 body
	body, _ := ioutil.ReadAll(responseClient.Body)
	clientIP := string(body)

	print(clientIP)

}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
  • 输出示例
106.224.145.147
1

5. 错误码

错误码描述
%s is not valid ip address.请求 IP 不是合法IP。 请求时请勿设置 X-Forwarded-For HTTP Header。