POSTPublicip-portraint

IP Address Risk Profiling

Provides an IP address risk profiling API service, enabling developers to quickly access IP risk profile information and integrate it into business systems.

Documentation

IP Address Risk Profiling API Overview

The IP Address Risk Profiling API helps developers quickly process IP risk assessments within their systems. It returns structured results and is ideal for scenarios such as cybersecurity analysis, access risk control, and data governance.

Use Cases

Integrate IP address risk profiling capabilities into internal systems, SaaS platforms, automated workflows, or admin dashboards.
Suitable for business scenarios requiring stable API calls, standardized responses, and orchestratable interface capabilities.
We recommend combining this with rate limiting, failure retry mechanisms, and result caching strategies to improve overall integration stability.

Integration Recommendations

Verify request parameter formats, authentication methods, and error code handling logic before integration.
For high-frequency calling scenarios, it is recommended to implement log tracking, timeout control, and idempotency handling.
If the results are used for risk control or automated decision-making, we advise incorporating secondary evaluations based on your business rules rather than relying solely on the API response.

Integration Examples

Includes ready-to-use Shell, Python, Go, Java, and PHP examples for direct integration.

Request Example

{
  "ip": "114.114.114.114",
  "coordsys": "wgs84"
}

Response Example

{
  "code": "SUCCESS",
  "message": "success",
  "data": {
    "riskLevel": "low",
    "tags": [],
    "isProxy": false,
    "isVpn": false
  }
}

Request Fields

The fields below are derived from example JSON for integration reference only.

Path	Type	Sample
ip	string	114.114.114.114
coordsys	string	wgs84

Response Fields

The fields below are derived from example JSON for integration reference only.

Path	Type	Sample
code	string	SUCCESS
message	string	success
data	object	{...}
data.riskLevel	string	low
data.tags	array	[]
data.isProxy	boolean	false
data.isVpn	boolean	false

curl --request POST \ --url 'https://openapi.toolkk.com/v1/ip-portraint' \ --header 'Content-Type: application/json' \ --header 'X-API-Key: YOUR_API_KEY' \ --data '{\n "ip": "114.114.114.114",\n "coordsys": "wgs84"\n}'

import os import requests url = "https://openapi.toolkk.com/v1/ip-portraint" payload = { "ip": "114.114.114.114", "coordsys": "wgs84" } headers = { "Content-Type": "application/json", "X-API-Key": os.getenv("TOOLKK_API_KEY", "YOUR_API_KEY"), } response = requests.request("POST", url, headers=headers, json=payload, timeout=30) response.raise_for_status() print(response.json())

package main import ( "bytes" "fmt" "io" "net/http" ) func main() { endpoint := "https://openapi.toolkk.com/v1/ip-portraint" payload := []byte("{\n \"ip\": \"114.114.114.114\",\n \"coordsys\": \"wgs84\"\n}") req, err := http.NewRequest("POST", endpoint, bytes.NewBuffer(payload)) if err != nil { panic(err) } req.Header.Set("Content-Type", "application/json") req.Header.Set("X-API-Key", "YOUR_API_KEY") resp, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer resp.Body.Close() body, err := io.ReadAll(resp.Body) if err != nil { panic(err) } fmt.Println(string(body)) }

import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; public class ToolkkExample { public static void main(String[] args) throws Exception { String payload = "{\n \"ip\": \"114.114.114.114\",\n \"coordsys\": \"wgs84\"\n}"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://openapi.toolkk.com/v1/ip-portraint")) .method("POST", HttpRequest.BodyPublishers.ofString(payload)) .header("Content-Type", "application/json") .header("X-API-Key", "YOUR_API_KEY") .build(); HttpResponse<String> response = HttpClient.newHttpClient() .send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body()); } }

<?php $endpoint = 'https://openapi.toolkk.com/v1/ip-portraint'; $payload = "{\n \"ip\": \"114.114.114.114\",\n \"coordsys\": \"wgs84\"\n}"; $ch = curl_init($endpoint); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_HTTPHEADER => [ 'Content-Type: application/json', 'X-API-Key: YOUR_API_KEY', ], CURLOPT_POSTFIELDS => $payload, ]); $response = curl_exec($ch); if ($response === false) { throw new RuntimeException(curl_error($ch)); } curl_close($ch); echo $response;

IP Address Risk Profiling

Documentation