IP 地址查询
查询 IP 对应的省市区、运营商、邮编和区号,兼容 IPv4 / IPv6
调用地址:https://api.ynlskj.com.cn/gateway/ip-query
复制
请求方法:GET
在其他地方怎么调用
请求地址用上面的调用地址,参数拼在网址后面,例如 ?ip=39.130.123.192
方法用 GET
API Key 只能放在请求头 X-API-Key,不要写进网址,也不要写进 Query 框
Key 在「个人中心 → API Key」里复制,登录后会自动填入你自己的 Key
参数说明
参数 位置 必填 说明
ipQuery 否 要查询的 IP。不传则查询当前请求方 IP
datatypeQuery 否 jsonp(推荐,返回 JSON)/ xml / txt
X-API-KeyHeader 是 你的 API Key
返回说明
字段 说明
retok 成功,err 失败
ip实际查询的 IP
data成功时的数组,依次为:国家、省份、城市、区县、运营商、邮编、区号、网络类型
msg本站提示,如「次数充足,剩余 99 次」或「次数不足,剩余 0 次」
remain_quota本次调用后的剩余次数
可直接复制的代码
未登录时示例只显示「你的密钥」。登录后会自动填入你自己的 Key,不会展示别人的。
PHP
Python
Go
JavaScript
Java
C#
cURL
复制
<?php
$ch = curl_init('https://api.ynlskj.com.cn/gateway/ip-query?ip=39.130.123.192');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['X-API-Key: 你的密钥'],
]);
echo curl_exec($ch);
复制
import requests
url = 'https://api.ynlskj.com.cn/gateway/ip-query?ip=39.130.123.192'
headers = {'X-API-Key': '你的密钥'}
resp = requests.get(url, headers=headers, timeout=15)
print(resp.text)
复制
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://api.ynlskj.com.cn/gateway/ip-query?ip=39.130.123.192", nil)
req.Header.Set("X-API-Key", "你的密钥")
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}
复制
fetch('https://api.ynlskj.com.cn/gateway/ip-query?ip=39.130.123.192', {
method: 'GET',
headers: {
'X-API-Key': '你的密钥'
}
})
.then(res => res.json())
.then(data => console.log(data));
复制
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.ynlskj.com.cn/gateway/ip-query?ip=39.130.123.192"))
.header("X-API-Key", "你的密钥")
.GET()
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
复制
using System.Net.Http;
var client = new HttpClient();
client.DefaultRequestHeaders.Add("X-API-Key", "你的密钥");
var result = await client.GetStringAsync("https://api.ynlskj.com.cn/gateway/ip-query?ip=39.130.123.192");
Console.WriteLine(result);
复制
curl -X GET "https://api.ynlskj.com.cn/gateway/ip-query?ip=39.130.123.192" \
-H "X-API-Key: 你的密钥"
请求参数演示
{
"ip": "39.130.123.192"
}
响应演示
{
"ret": "ok",
"ip": "39.130.123.192",
"data": [
"中国",
"云南",
"昆明",
"官渡",
"移动",
"650200",
"0871",
"城域网"
],
"msg": "次数充足,剩余 99999 次",
"remain_quota": 99999
}