Gate erstellen
Gibt eine neue Bestellung für Datacenter Proxy auf und bucht den Betrag von Ihrem Guthaben ab.
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 datacenter.
Pflicht für ISP, Datacenter und Gaming. Abrufbar über den Endpoint GET /locations. Das Land ergibt sich automatisch aus dem Standort.
Pflicht für ISP, Datacenter und Gaming, 1-1000. Ohne Bestand wird daraus eine Vorbestellung, die mindestens 250 erfordert.
ISP und Datacenter: Der Zugriffsmodus ist Pflicht. true = alle Websites (kostenpflichtige Option); bei false ist eine nicht leere Liste targetUrls nötig (Zielmodus). Fehlt beides, wird die Anfrage abgelehnt; so wird nie für einen Modus abgebucht, den Sie nicht gewählt haben. Bei Gaming nicht verwendet.
ISP und Datacenter, Zielmodus: Domains aus der Liste GET /target-urls. Bei unlimitedAccess true nicht senden.
ISP, Datacenter und Gaming. auto: HTTP und SOCKS5 auf demselben Port, dazu UDP ASSOCIATE; http: nur HTTP/HTTPS; socks5: nur SOCKS5. Ohne Angabe gilt bei ISP und Datacenter auto, bei Gaming socks5 (default_protocol in der Antwort von GET /catalog). Der Alias parentUpstreamProtocol wird ebenfalls akzeptiert (AUTO, HTTP oder SOCKS; Groß-/Kleinschreibung egal); senden Sie nur eines der beiden Felder. Bei Residential/Mobile nicht senden; dort laufen HTTP und SOCKS5 gleichzeitig über getrennte Ports.
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.
Nur ISP-Familie: zusätzliches IP-Whitelist-Kontingent, Aufpreis pro Bestellung. Bei Residential/Mobile kommt 400 invalid_request zurück.
ISP-Familie: nicht fortlaufende (gestreute) IPs, kostenpflichtig.
ISP-Familie: 2× Bandbreite, kostenpflichtig.
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).