{
  "openapi": "3.0.3",
  "info": {
    "title": "全球IP归属地查询",
    "description": "【包含IP地址最全】将IP信息转换为地理位置信息，精确到县区。专业的IP地理位置查询系统，采用最新全球IP地址地理位置信息数据库，查询操作简单方便，定期更新维护IP地址数据库内容，信息准确，欢迎使用。",
    "termsOfService": "https://www.showapi.com/helpcenter/view#/4019/2",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://route.showapi.com"
    }
  ],
  "paths": {
    "/20-2": {
      "x-pointCode": 2,
      "x-mode": "mapping",
      "x-read-timeout": 20,
      "x-connect-timeout": 20,
      "post": {
        "summary": "域名查询",
        "description": "可以根据您传入的域名查询该域名对应的IP地址信息。广泛应用于网络管理、信息安全监测和域名解析等场景，可以帮助您快速获取域名的网络位置，从而更好地进行网络资源的分配和监控。",
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ShowapiResEnvelope"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "showapi_res_body": {
                          "type": "object",
                          "properties": {
                            "ip": {
                              "type": "string",
                              "description": "对应的ip"
                            },
                            "country": {
                              "type": "string",
                              "description": "国家"
                            },
                            "city": {
                              "type": "string",
                              "description": "城市"
                            },
                            "county": {
                              "type": "string",
                              "description": "乡镇"
                            },
                            "isp": {
                              "type": "string",
                              "description": "运营商"
                            },
                            "region": {
                              "type": "string",
                              "description": "省份"
                            }
                          },
                          "description": "业务返回体"
                        }
                      }
                    }
                  ]
                }
              }
            }
          }
        },
        "operationId": "20_2_POST",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "properties": {
                  "domain": {
                    "type": "string",
                    "description": "域名"
                  }
                },
                "required": [
                  "domain"
                ]
              }
            }
          }
        }
      }
    },
    "/20-1": {
      "x-pointCode": 1,
      "x-mode": "mapping",
      "x-read-timeout": 5,
      "x-connect-timeout": 5,
      "post": {
        "summary": "全球IP地址查询",
        "description": "包含IP地址最全，精确到县区。支持国内外IP地址查询，全球覆盖99.999%以上。",
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ShowapiResEnvelope"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "showapi_res_body": {
                          "type": "object",
                          "properties": {
                            "area": {
                              "type": "string",
                              "description": "片区"
                            },
                            "country": {
                              "type": "string",
                              "description": "国家"
                            },
                            "county": {
                              "type": "string",
                              "description": "县级"
                            },
                            "city": {
                              "type": "string",
                              "description": "市级"
                            },
                            "isp": {
                              "type": "string",
                              "description": "运营商"
                            },
                            "region": {
                              "type": "string",
                              "description": "省级"
                            },
                            "ret_code": {
                              "type": "string",
                              "description": "0为成功，其他为失败"
                            },
                            "lnt": {
                              "type": "string",
                              "description": "经度"
                            },
                            "lat": {
                              "type": "string",
                              "description": "纬度"
                            },
                            "city_code": {
                              "type": "string",
                              "description": "我国行政区划编码"
                            }
                          },
                          "description": "业务返回体"
                        }
                      }
                    }
                  ]
                }
              }
            }
          }
        },
        "operationId": "20_1_POST",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "properties": {
                  "ip": {
                    "type": "string",
                    "description": "要查询的ip"
                  }
                },
                "required": [
                  "ip"
                ]
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "AppKeyAuth": {
        "type": "apiKey",
        "in": "query",
        "name": "appKey",
        "description": "从 ShowAPI 控制台获取的 appKey，管理地址：https://www.showapi.com/console#/myApp"
      }
    },
    "schemas": {
      "ShowapiResEnvelope": {
        "type": "object",
        "description": "ShowAPI 统一返回包裹（业务数据位于 showapi_res_body）",
        "properties": {
          "showapi_res_code": {
            "type": "integer",
            "description": "API 返回的状态码"
          },
          "showapi_res_error": {
            "type": "string",
            "description": "API 返回的错误信息"
          },
          "showapi_res_id": {
            "type": "string",
            "description": "API 请求的唯一标识"
          },
          "showapi_fee_num": {
            "type": "integer",
            "description": "API 调用计费次数"
          }
        }
      }
    }
  },
  "security": [
    {
      "AppKeyAuth": []
    }
  ],
  "externalDocs": {
    "url": "https://www.showapi.com/apiGateway/view/20?tab=book"
  },
  "x-apiCode": "20",
  "x-is-own": false,
  "x-is-op": true
}