# बनाने और हटाने का दायरा

`GET /account/api/v1/residential/lists/options`

## प्राधिकरण

`Authorization: Bearer YOUR_ARNPROXY_API_KEY`

`Accept: application/json`

आवश्यक अनुमति: `residential_management`

## पैरामीटर

| नाम | प्रकार | आवश्यक / सशर्त | डिफ़ॉल्ट | विवरण |
|---|---|---|---|---|
| `package_id` (query) | integer | सशर्त | — | package_id या list_id में ठीक एक दें, दोनों नहीं। |
| `list_id` (query) | integer | सशर्त | — | package_id या list_id में ठीक एक दें, दोनों नहीं। |

## अनुरोध उदाहरण

### curl

```curl
printf 'Authorization: Bearer %s\n' "$ARNPROXY_API_KEY" |
  curl --silent --show-error --header @- \
    --header 'Accept: application/json' \
    --connect-timeout 10 --max-time 30 \
    'https://www.arnproxy.com/account/api/v1/residential/lists/options?package_id=YOUR_PACKAGE_ID'
```

### python

```python
import os, requests

headers = {"Authorization": "Bearer " + os.environ["ARNPROXY_API_KEY"]}
response = requests.get(
    "https://www.arnproxy.com/account/api/v1/residential/lists/options?package_id=YOUR_PACKAGE_ID",
    headers=headers,
    timeout=(10, 30), allow_redirects=False
)
print(response.status_code, response.text)
# No automatic write retry.
```

### javascript

```javascript
const headers = { Authorization: `Bearer ${process.env.ARNPROXY_API_KEY}` };
const response = await fetch("https://www.arnproxy.com/account/api/v1/residential/lists/options?package_id=YOUR_PACKAGE_ID", {
  method: 'GET', headers, redirect: 'error',
  signal: AbortSignal.timeout(30000)
});
console.log(response.status, await response.text());
// A write timeout is ambiguous; query its saved operation.
```

### php

```php
<?php
$headers = ['Accept: application/json',
    'Authorization: Bearer '.getenv('ARNPROXY_API_KEY')];
$ch = curl_init('https://www.arnproxy.com/account/api/v1/residential/lists/options?package_id=YOUR_PACKAGE_ID');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => $headers,
    CURLOPT_FOLLOWLOCATION => false,
    CURLOPT_SSL_VERIFYPEER => true, CURLOPT_SSL_VERIFYHOST => 2,
    CURLOPT_CONNECTTIMEOUT => 10, CURLOPT_TIMEOUT => 30,
]);
$result = curl_exec($ch);
if ($result === false) {
    // Do not repeat a write; use the original operation key.
    throw new RuntimeException('Transport result unknown');
}
echo curl_getinfo($ch, CURLINFO_HTTP_CODE).PHP_EOL.$result;
curl_close($ch);
```

### go

```go
package main

import (
  "fmt"
  "io"
  "net/http"
  "os"
  "time"
)

func main() {
  client := &http.Client{Timeout: 30*time.Second,
    CheckRedirect: func(req *http.Request, via []*http.Request) error {
      return http.ErrUseLastResponse
    }}
  var body io.Reader
  req, err := http.NewRequest("GET", "https://www.arnproxy.com/account/api/v1/residential/lists/options?package_id=YOUR_PACKAGE_ID", body)
  if err != nil { panic(err) }
  req.Header.Set("Authorization", "Bearer "+os.Getenv("ARNPROXY_API_KEY"))
  res, err := client.Do(req); if err != nil { panic(err) }
  defer res.Body.Close()
  data, err := io.ReadAll(res.Body); if err != nil { panic(err) }
  fmt.Println(res.StatusCode, string(data))
}
```

### csharp

```csharp
using System;
using System.IO;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;

using var handler = new HttpClientHandler { AllowAutoRedirect = false };
using var client = new HttpClient(handler) { Timeout = TimeSpan.FromSeconds(30) };
using var request = new HttpRequestMessage(HttpMethod.Get,
    "https://www.arnproxy.com/account/api/v1/residential/lists/options?package_id=YOUR_PACKAGE_ID");
request.Headers.Authorization = new AuthenticationHeaderValue(
    "Bearer", Environment.GetEnvironmentVariable("ARNPROXY_API_KEY"));
using var response = await client.SendAsync(request);
Console.WriteLine((int)response.StatusCode);
Console.WriteLine(await response.Content.ReadAsStringAsync());
// Never automatically retry an ambiguous write.
```

### java

```java
import java.net.URI;
import java.net.http.*;
import java.nio.charset.StandardCharsets;
import java.nio.file.*;

// Inside your application method:
var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder(URI.create("https://www.arnproxy.com/account/api/v1/residential/lists/options?package_id=YOUR_PACKAGE_ID"))
    .header("Authorization", "Bearer " + System.getenv("ARNPROXY_API_KEY"))
    .header("Accept", "application/json")
    .GET()
    .build();
var response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
```

## उत्तर · HTTP 200

```json
{
  "ok": true,
  "data": {
    "package_id": 20001,
    "list_id": null,
    "title": null,
    "package_state": "active",
    "revision": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
    "creation_available": true,
    "deletion_available": false,
    "create_authentication": "login_password",
    "create_authentication_methods": [
      "login_password",
      "ip_auth"
    ],
    "authorized_ip_families": [
      4
    ],
    "authorized_ip_max": 20,
    "authorized_ips": null,
    "existing_list_ip_edit": false,
    "port_count_min": 1,
    "port_count_max": 1000,
    "rotation_min": -1,
    "rotation_max": 3600,
    "gb_purchase": false,
    "package_deletion": false
  },
  "meta": {
    "request_id": "000000000000000000000001",
    "phase": "public_v1",
    "source": "arnproxy_records"
  }
}
```

| नाम | प्रकार | सशर्त | विवरण |
|---|---|---|---|
| `ok` | boolean | — | सफलता संकेत; false पर error.code देखें। |
| `data` | object | — | कार्रवाई-विशिष्ट परिणाम; उदाहरण कृत्रिम और समझाने के लिए हैं। |
| `data.package_id` | integer | — | संबंधित ARNPROXY रिकॉर्ड ID; आंतरिक प्रदाता ID के बदले इसे लें। |
| `data.list_id` | integer|null | — | संबंधित ARNPROXY रिकॉर्ड ID; आंतरिक प्रदाता ID के बदले इसे लें। |
| `data.title` | string|null | — | title का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें। |
| `data.package_state` | string | — | package state का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें। |
| `data.revision` | string | — | संबंधित बदलाव/मूल्य पुष्टि में अपरिवर्तित लौटाने वाला ताज़गी संकेत। |
| `data.creation_available` | boolean | — | शर्तों/अनुमतियों के अनुसार उपलब्धता, स्टॉक या प्रदाता की गारंटी नहीं। |
| `data.deletion_available` | boolean | — | शर्तों/अनुमतियों के अनुसार उपलब्धता, स्टॉक या प्रदाता की गारंटी नहीं। |
| `data.create_authentication` | string | — | create authentication का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें। |
| `data.create_authentication_methods` | array | — | create authentication methods का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें। |
| `data.create_authentication_methods[]` | string | — | create authentication methods का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें। |
| `data.authorized_ip_families` | array | — | authorized ip families का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें। |
| `data.authorized_ip_families[]` | integer | — | authorized ip families का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें। |
| `data.authorized_ip_max` | integer | — | authorized ip max का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें। |
| `data.authorized_ips` | string[]|null | — | authorized ips का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें। |
| `data.existing_list_ip_edit` | boolean | — | existing list ip edit का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें। |
| `data.port_count_min` | integer | — | port count min का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें। |
| `data.port_count_max` | integer | — | port count max का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें। |
| `data.rotation_min` | integer | — | rotation min का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें। |
| `data.rotation_max` | integer | — | rotation max का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें। |
| `data.gb_purchase` | boolean | — | gb purchase का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें। |
| `data.package_deletion` | boolean | — | package deletion का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें। |
| `meta` | object | — | अनुरोध संबद्धता और डेटा-स्रोत मेटाडेटा। |
| `meta.request_id` | string | — | इस HTTP अनुरोध की पहचान; कार्रवाई कुंजी या ऑर्डर ID नहीं। |
| `meta.phase` | string | — | phase का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें। |
| `meta.source` | string | — | डेटा स्रोत; स्थानीय रिकॉर्ड और लाइव प्रदाता क्वेरी अलग प्रमाण हैं। |

## व्यवहार और महत्वपूर्ण नोट

- पैकेज/सूची ID ARNPROXY रिकॉर्ड ID हैं, प्रदाता कुंजियाँ नहीं। पुराना स्नैपशॉट पहुँच नहीं देता; ज़रूरत पर residential_package_refresh लें।
- नई सूची login_password या ip_auth लेती है। IP सूची में 1–20 अद्वितीय सार्वजनिक IPv4। सूची हटने से GB पैकेज नहीं हटता, केवल उस सूची के कनेक्शन बंद होते हैं।

प्रमाणीकरण और जाँच निष्पादन से पहले अनुरोध रोक सकते हैं। त्रुटि संदर्भ देखें और सहायता के लिए request_id रखें। कुंजी या पासवर्ड न भेजें।

[त्रुटियाँ और सीमाएँ](https://docs.arnproxy.com/hi/api-v1/errors)