Gezielte Sitzungsverbindungen

POST/account/api/v1/residential/sessions/export

Autorisierung

Authorization	`Bearer YOUR_ARNPROXY_API_KEY`
Erforderliche Berechtigung	`credentials`
Accept	`application/json`
Content-Type	`application/json`

Parameter

Name	Typ	Beschreibung
`list_id` bodyErforderlich	`integer`	Eigene ARNPROXY-Verbindungslisten-ID, keine Anbieter-Listen-ID.
`country` bodyOptional	`string`	Zwei Großbuchstaben als Ländercode, z. B. US.
`subdivision` bodyOptional	`integer`	Positiver Regionscode; country erforderlich.
`city` bodyOptional	`string`	country erforderlich; höchstens 80 Bytes aus Buchstaben/Ziffern mit einzelnen Leerzeichen/Bindestrichen.
`isp_id` bodyOptional	`integer`	ID aus residential_isp_codes; 1–2147483647.
`asn` bodyOptional	`integer`	ASN von 1–4294967295.
`zip` bodyOptional	`string`	1–16 Buchstaben/Ziffern/Bindestriche; country erforderlich.
`session` bodyOptional	`string`	1–64 ASCII-Buchstaben/Ziffern.
`ttl` bodyOptional	`string`	Positive Zahl mit s/m/h, z. B. 15m; höchstens 86400 Sekunden, session erforderlich.
`format` bodyOptional	`string`	uri \| host_port_user_pass \| user_pass_host_port. Zugangsdaten erfordern credentials. Auch csv \| custom. Standardwert: `"uri"`
`protocol` bodyOptional	`string`	http oder socks5; bestimmt nur bei uri-Ausgabe das Präfix. Standardwert: `"http"`
`offset` bodyOptional	`integer`	0–999, kleiner als die Portanzahl. Standardwert: `0`
`limit` bodyOptional	`integer`	1–1000; Standard 10. Standardwert: `10`
`columns` bodyBedingt	`string[]`	Nur CSV: id, endpoint, ip, port, login, password. Standard ["id","endpoint"]. login/password benötigen credentials.
`template` bodyBedingt	`string`	Für custom erforderlich, maximal 200 Zeichen. Platzhalter: %endpoint%, %ip%, %port%, %id%, %login%, %username%, %password%, %login_url%, %password_url%. Steuerzeichen und unbekannte Platzhalter unzulässig.

Anfrageinhalt

Ersetzen Sie YOUR_/FROM_ durch Werte aus Katalog, Angebot oder Umfang. Beispiele lassen die Zustimmung auf false; bestätigen Sie echte Vorgänge nur bewusst.

request.json

{
    "list_id": "YOUR_SPECIAL_LIST_ID",
    "session": "Example001",
    "ttl": "15m",
    "format": "uri",
    "limit": 1
}

Anfragebeispiel

cURL

printf 'Authorization: Bearer %s\n' "$ARNPROXY_API_KEY" |
  curl --silent --show-error --header @- \
    --header 'Accept: application/json' \
    --connect-timeout 10 --max-time 30 \
    --request POST --header 'Content-Type: application/json' \
    --data-binary @request.json \
    'https://www.arnproxy.com/account/api/v1/residential/sessions/export'

Beispiele werden hier nicht ausgeführt. Speichern Sie den API-Schlüssel in einer serverseitigen Umgebungsvariablen, nie in URLs oder Browsercode. Bereiten Sie request.json für POST vor.

Antworten

200Erfolgsantwort

application/json

{
    "ok": true,
    "data": {
        "list_id": 30002,
        "package_id": 20001,
        "format": "uri",
        "protocol": "http",
        "items": [
            "http://ExampleUser_s_Example001_ttl_15m:ExamplePassword@res.arnproxy.com:10000"
        ],
        "count": 1,
        "next_offset": 1,
        "session": "Example001",
        "ttl": "15m",
        "credentials_included": true,
        "provider_requests": 0,
        "database_changes": 0,
        "proxy_connections_tested": false,
        "connection_success_guaranteed": false,
        "snapshot": {
            "source": "arnproxy_records",
            "observed_at": "2030-01-01T12:00:00+00:00",
            "fresh": true,
            "max_age_seconds": 3600,
            "reason": null
        },
        "source": "arnproxy_records"
    },
    "meta": {
        "request_id": "000000000000000000000001",
        "phase": "public_v1",
        "source": "arnproxy_records"
    }
}

Antwortfelder und Typen

Name	Typ	Beschreibung
`ok`	`boolean`	Erfolgskennzeichen; bei false error.code prüfen.
`data`	`object`	Vorgangsspezifisches Ergebnis; Beispiele sind synthetisch und dienen der Veranschaulichung.
`data.list_id`	`integer`	Zugehörige ARNPROXY-Datensatz-ID statt interner Anbieter-ID verwenden.
`data.package_id`	`integer`	Zugehörige ARNPROXY-Datensatz-ID statt interner Anbieter-ID verwenden.
`data.format`	`string`	Vorgangsspezifischer Wert für format. Rückgabetyp beibehalten und Verhaltenshinweise beachten.
`data.protocol`	`string`	Vorgangsspezifischer Wert für protocol. Rückgabetyp beibehalten und Verhaltenshinweise beachten.
`data.items`	`array`	Datensätze dieser Seite oder formatierte Verbindungen; eine leere Liste kann gültig sein.
`data.items[]`	`string`	Datensätze dieser Seite oder formatierte Verbindungen; eine leere Liste kann gültig sein.
`data.count`	`integer`	Anzahl sichtbarer Datensätze oder erzeugter Verbindungen.
`data.next_offset`	`integer`	Nächster Verbindungsausgabe-Offset oder null bei Abschluss.
`data.session`	`string`	Vorgangsspezifischer Wert für session. Rückgabetyp beibehalten und Verhaltenshinweise beachten.
`data.ttl`	`string`	Vorgangsspezifischer Wert für ttl. Rückgabetyp beibehalten und Verhaltenshinweise beachten.
`data.credentials_included`	`boolean`	Ob Ergebnis/Schlüssel sensible Zugangsdaten enthält oder erlaubt.
`data.provider_requests`	`integer`	Vorgangsspezifischer Wert für provider requests. Rückgabetyp beibehalten und Verhaltenshinweise beachten.
`data.database_changes`	`integer`	Vorgangsspezifischer Wert für database changes. Rückgabetyp beibehalten und Verhaltenshinweise beachten.
`data.proxy_connections_tested`	`boolean`	Vorgangsspezifischer Wert für proxy connections tested. Rückgabetyp beibehalten und Verhaltenshinweise beachten.
`data.connection_success_guaranteed`	`boolean`	Vorgangsspezifischer Wert für connection success guaranteed. Rückgabetyp beibehalten und Verhaltenshinweise beachten.
`data.snapshot`	`object`	Quelle/Zeit/Aktualität der Paketbeobachtung; veraltete Daten gewähren keinen Verwaltungszugriff.
`data.snapshot.source`	`string`	Datenquelle; lokale Datensätze und Live-Anbieterabfragen sind unterschiedliche Nachweise.
`data.snapshot.observed_at`	`string`	Zeitstempel im vom API gelieferten Format; Beispieldaten sind synthetisch.
`data.snapshot.fresh`	`boolean`	Ob die Beobachtung innerhalb des Aktualitätsfensters liegt.
`data.snapshot.max_age_seconds`	`integer`	Maximal erlaubtes Alter in Sekunden für eine aktuelle Beobachtung.
`data.snapshot.reason`	`string\|null`	Fester Grundcode oder null, niemals ungefilterter Anbieterfehlertext.
`data.source`	`string`	Datenquelle; lokale Datensätze und Live-Anbieterabfragen sind unterschiedliche Nachweise.
`meta`	`object`	Metadaten zu Anfragezuordnung und Datenquelle.
`meta.request_id`	`string`	Kennung dieser HTTP-Anfrage, kein Vorgangsschlüssel oder Bestell-ID.
`meta.phase`	`string`	Vorgangsspezifischer Wert für phase. Rückgabetyp beibehalten und Verhaltenshinweise beachten.
`meta.source`	`string`	Datenquelle; lokale Datensätze und Live-Anbieterabfragen sind unterschiedliche Nachweise.

Fehlerantwort

HTTP 401 · INVALID_API_KEY

{
  "ok": false,
  "error": { "code": "INVALID_API_KEY" },
  "meta": { "request_id": "000000000000000000000001" }
}

Authentifizierung und Validierung können eine Anfrage vor der Ausführung ablehnen. Beachten Sie die Fehlerreferenz und bewahren Sie request_id für den Support auf. Senden Sie niemals Schlüssel oder Passwörter. Fehler & Limits →

Verhalten & wichtige Hinweise

Paket-/Listen-IDs sind ARNPROXY-Datensatz-IDs, keine Anbieterkennungen. Veralteter Snapshot gewährt keinen Zugriff; gegebenenfalls residential_package_refresh nutzen.
Sitzungszusätze benötigen eine separat angelegte, verifizierte Spezialliste. TTL erfordert session mit 1–64 Buchstaben/Ziffern; positive s/m/h maximal 24 Stunden. Textformatierung verbindet nicht; echte Nutzung verbraucht Traffic.
Ausgaben mit Zugangsdaten benötigen credentials. Verbindungen, Passwörter und Authorization-Header niemals protokollieren oder an den Support senden.