Gate erstellen
Gibt eine neue Bestellung für Residential Proxy auf; die Nutzung wird pro GB von Ihrem Guthaben abgebucht.
https://api.proxynet.io/api/v1/orders
Es gelten dieselbe Preisgestaltung, derselbe Stufenrabatt und dieselbe Bestands- und Guthabenprüfung. Protokoll, Standort, Ziel-Domains oder der Modus „alle Websites“ sowie alle Zusatzoptionen werden unterstützt.
Werden Benutzername und Passwort nicht gesendet, werden sie automatisch erzeugt und in der Antwort zurückgegeben (sofern das Token auch proxies:read hat). Fehlt der Dienstname, wird er im Format des Panels erzeugt. Welche Felder je Typ gelten, zeigt die Tabelle auf der Seite Kostenpflichtige Vorgänge; unbekannte Felder werden abgelehnt.
Die Bestellung ist möglicherweise nicht sofort aktiv (Vorbereitung, Vorbestellung oder Verzögerung beim Anbieter). Ist meta.ready false, ist meta.warning gefüllt; fragen Sie den Endpoint Dienstdetails ab, bis state active ist, bevor Sie den Dienst zur Nutzung freigeben.
Autorisierung
Wird als Bearer <token> gesendet. Dieser Endpoint erfordert die Berechtigung orders:write (Bestellen); ein Token ohne diese Berechtigung erhält 403.
Header
Ein eindeutiger Wert für jeden Bestellversuch (z. B. eine UUID). Wiederholen Sie bei einem Timeout mit DEMSELBEN Wert; es wird nicht doppelt abgebucht. Speichern Sie den Wert in einer Variablen und erzeugen Sie für die Wiederholung keinen neuen.
Body
Diensttyp; auf dieser Seite residential.
Hohe Verbindungszahl. In der ISP-Familie kostenpflichtig: 100 statt 50 gleichzeitige Verbindungen pro IP. Bei Residential/Mobile kostenlos: Das Verbindungslimit des Gateways steigt von 500 auf 1000; in der Antwort sichtbar als options.high_connection.
Residential/Mobile: Standardland auf Bestellebene, ISO-Code (TR, DE, US, GB, FR, IT, ES, NL, PL, RU). In der ISP-Familie ergibt sich das Land aus locationId; wird das Feld dort gesendet, wird es abgelehnt.
Residential/Mobile, optional: Traffic-Limit (GB), mindestens 0.001. 0 bedeutet kein festes Limit. Ohne Angabe ist die Nutzung durch Ihr Guthaben begrenzt.
Optional; ohne Angabe automatisch erzeugt und in der Antwort zurückgegeben. 3-40 Zeichen: Buchstaben, Ziffern, _ oder -. Um ihn selbst zu wählen, muss Ihre Stufe das erlauben; sonst kommt tier_required zurück.
Optional; ohne Angabe automatisch erzeugt. 6-40 Zeichen; @ . : ! und Leerzeichen sind nicht erlaubt. Darf nicht mit dem Benutzernamen übereinstimmen. Ein Passwort mit # / ? % muss in einer URL (z. B. socks5://user:pass@host) percent-encodiert werden; vom System erzeugte Passwörter enthalten kein #.
Optional. Der im Panel angezeigte Dienstname, höchstens 80 Zeichen. Ohne Angabe wird er im Format des Panels erzeugt (z. B. ISP Proxy #a1b2c3d4).