دریافت اطلاعات ای پی به صورت کامل

با استفاده از این وب سرویس میتوانید اطلاعات ای پی مورد نظر خود را به صورت کامل دریافت کنید.

مشخصات

مشخصه	مقدار
دسته‌بندی	اطلاعات
وضعیت	فعال
نسخه API	apis-1
فرمت پاسخ	JSON
آدرس پایه	https://open.nestapi.ir
مسیر	/apis-1/ip-info
لینک کامل	https://open.nestapi.ir/apis-1/ip-info

متدهای HTTP

متد	مسیر	نوع ورودی
GET	/apis-1/ip-info	Query String

پارامترها

پارامترهای Query String

نام	نوع	الزامی	پیش‌فرض	توضیحات
ip	string	خیر	آی‌پی درخواست‌دهنده	آدرس IPv4 یا IPv6 برای استعلام

نمونه درخواست

لینک مستقیم

GET https://open.nestapi.ir/apis-1/ip-info?ip=8.8.8.8

نمونه کد

cURL

curl -X GET "https://open.nestapi.ir/apis-1/ip-info?ip=8.8.8.8"

PHP

<?php

// composer require nestapi/nestapi
require 'vendor/autoload.php';

use NestApi\NestApi;
use NestApi\Exception\ApiException;
use NestApi\Exception\TransportException;

$api = new NestApi();

try {
    $response = $api->ipInfo(ip: '8.8.8.8');

    print_r($response->data);
} catch (ApiException $e) {
    // Error reported by the API (validation, not found, rate limit, ...)
    echo $e->getMessage();
} catch (TransportException $e) {
    // Network error or unusable response; not a subclass of ApiException
    echo 'Network error: ' . $e->getMessage();
}

Python

# pip install nestapi-py
from nestapi import ApiError, NestApi, TransportError

with NestApi() as api:
    try:
        response = api.ip_info(ip="8.8.8.8")

        print(response.data)
    except ApiError as e:
        # Error reported by the API (validation, not found, rate limit, ...)
        print(e.error_code, e)
    except TransportError as e:
        # Network error or unusable response; not a subclass of ApiError
        print("Network error:", e)

JavaScript

// npm install @devh3n/nestapi
import { ApiError, NestApi, TransportError } from "@devh3n/nestapi";

const api = new NestApi();

try {
  const response = await api.ipInfo({ ip: "8.8.8.8" });

  console.log(response.data);
} catch (error) {
  if (error instanceof ApiError) {
    // Error reported by the API (validation, not found, rate limit, ...)
    console.error(error.errorCode, error.message);
  } else if (error instanceof TransportError) {
    // Network error or unusable response; not a subclass of ApiError
    console.error("Network error:", error.message);
  }
}

کدهای خطا

کد	وضعیت	علت
NOT_FOUND	404	مسیر وجود ندارد، یا متد روی آن ثبت نشده
PARAM_NOT_FOUND	400	پارامتر لازم ارسال نشده
VALIDATION_ERROR	422	پارامتر آمده ولی نوع، قالب یا بازه‌اش نادرست است
INVALID_IP	400	آدرس IP واردشده معتبر نیست
IP_LOOKUP_FAILED	404	اطلاعاتی برای آدرس IP ارسال‌شده یافت نشد

لینک های بیشتر

• راهنمای اتصال به سرویس
• فرمت خروجی موفقیت API
• فرمت خروجی خطای API
• کدهای خطای عمومی