# گرفتن IP آدرس هاست و ارتباطی – Get IP

# دریافت از طریق API

<table border="1" class="has-fixed-layout align-center" id="bkmrk-%D8%B9%D9%86%D9%88%D8%A7%D9%86-%D9%88%D8%B6%D8%B9%DB%8C%D8%AA-%D9%85%D9%82%D8%A7%D8%AF%DB%8C%D8%B1-%D8%AA" style="border-collapse: collapse;"><tbody><tr><td class="has-text-align-left" data-align="left">**عنوان**</td><td>**وضعیت**</td><td>**مقادیر**</td><td>**توضیحات**</td></tr><tr><td class="has-text-align-left" data-align="left">Method</td><td>اجباری</td><td>GET</td><td>متد ارسال درخواست</td></tr><tr><td class="has-text-align-left" data-align="left">Domain</td><td>اجباری</td><td>نام دامنه ثبت شده در اتوماسیون</td><td> </td></tr><tr><td class="has-text-align-left" data-align="left">Api Url</td><td>اجباری</td><td>دامنه هسته مرکزی سرویس</td><td> </td></tr><tr><td class="has-text-align-left" data-align="left">Api version</td><td>اجباری</td><td>به نسخه فعلی سرویس API تلقی میشود که در قسمت [پیش نیازهای اتوماسیون](https://airplus.app/docs/%d9%be%db%8c%d8%b4-%d9%86%db%8c%d8%a7%d8%b2%d9%87%d8%a7-%d9%88-%d8%b4%d8%b1%d8%a7%db%8c%d8%b7-%d8%a7%d8%ae%d8%b0-api-%da%86%d8%a7%d8%b1%d8%aa%d8%b1%db%8c/) به ریز شرح داده شده است.</td><td> </td></tr></tbody></table>

توضیحات ارسال درخواست

# سربرگ – Header

در این روش شما باید درخواست خود را از طریق لینک زیر ارسال فرمائید.

```
{{Api Url}}/ip

HEADER
GET /api/reservation/{{Api version}}/ip HTTP/1.1
Host: {{Your Host}}
Content-Type: application/json
Domain: {{Your Domain}}
```

API Url از طریق پنل کاربری قابل مشاهده خواهد بود

# مقادیر ارسالی – Request Data

این API نیازی به ارسال داده ندارد.

# پاسخ صحیح – Response True

<table border="1" class="has-fixed-layout align-center" id="bkmrk-%D8%B9%D9%86%D9%88%D8%A7%D9%86-%D9%86%D9%88%D8%B9-%D9%85%D9%82%D8%A7%D8%AF%DB%8C%D8%B1-%D8%AA%D9%88%D8%B6" style="border-collapse: collapse;"><tbody><tr><td class="has-text-align-left" data-align="left">**عنوان**</td><td>**نوع**</td><td>**مقادیر**</td><td>**توضیحات**</td></tr><tr><td class="has-text-align-left" data-align="left">**payload**</td><td>Object</td><td> </td><td> </td></tr><tr><td class="has-text-align-left" data-align="left">payload.host</td><td>IP</td><td>آدرس هاست ارسال کننده درخواست</td><td>یک آدرس IP برمیگرداند</td></tr><tr><td class="has-text-align-left" data-align="left">payload.ip</td><td>IP</td><td>آدرس کاربر ارسال کننده درخواست</td><td>یک آدرس IP برمیگرداند</td></tr><tr><td class="has-text-align-left" data-align="left">**meta**</td><td>Object</td><td> </td><td> </td></tr><tr><td class="has-text-align-left" data-align="left">meta.timestamp</td><td>Timestamp</td><td> زمان تولید پاسخ</td><td> این زمان بر اساس timestamp می باشد – در صورت نیاز از این زمان استفاده شود.</td></tr></tbody></table>

دریافت این پاسخ با Status Code 200 دریافت خواهد شد.

```
{
    "payload": {
        "host": "192.168.0.5",
        "ip": "192.168.0.170"
    },
    "meta": {
       "timestamp": "Timestamp" // Timestamp
    }
}
```

# پاسخ نادرست – Response False

<table border="1" class="has-fixed-layout align-center" id="bkmrk-%D8%B9%D9%86%D9%88%D8%A7%D9%86-%D9%86%D9%88%D8%B9-%D9%85%D9%82%D8%A7%D8%AF%DB%8C%D8%B1-%D8%AA%D9%88%D8%B6" style="border-collapse: collapse;"><tbody><tr><td class="has-text-align-left" data-align="left">**عنوان**</td><td>**نوع**</td><td>**مقادیر**</td><td>**توضیحات**</td></tr><tr><td class="has-text-align-left" data-align="left">**error**</td><td>Object</td><td> </td><td> </td></tr><tr><td class="has-text-align-left" data-align="left">error.code</td><td>Integer</td><td>شماره خطا مربوطه</td><td>جهت استعلام خطا میتوانید از طریق [این لینک](https://airplus.app/docs/%d9%85%d8%af%db%8c%d8%b1%db%8c%d8%aa-%d8%ae%d8%b7%d8%a7%d9%87%d8%a7-error-handling/) اقدام کنید.</td></tr><tr><td class="has-text-align-left" data-align="left">**meta**</td><td>Object</td><td> </td><td> </td></tr><tr><td class="has-text-align-left" data-align="left">meta.timestamp</td><td>Timestamp</td><td> زمان تولید پاسخ</td><td> این زمان بر اساس timestamp می باشد – در صورت نیاز از این زمان استفاده شود.</td></tr></tbody></table>

```
{
  "error": {
    "code":"Error Code"
  },
  "meta": {
    "timestamp": "Timestamp" // Timestamp
  }
}
```

در صورت مشاهده Status Code 404 URL درخواست خود را به اشتباه وارد نموده اید.