API-Referenz

Mit der Proxynet API lesen Sie die Proxy-Dienste Ihrer Organisation aus Ihrem eigenen System aus, geben neue Bestellungen auf und verwalten bestehende Dienste. Alle Anfragen und Antworten sind JSON; die Authentifizierung erfolgt über ein Bearer-Token.

Basis-URL

https://api.proxynet.io/api/v1

Verwenden Sie diese Adresse für alle Aufrufe von Server zu Server. Die Panel-Adresse (app.proxynet.io) steht hinter Cloudflare und kann bei Anfragen von manchen Server-IPs eine Browserprüfung verlangen; api.proxynet.io stellt nur die API bereit und führt keine Prüfung durch. Token und Pfade sind bei beiden gleich.

Authentifizierung

Fügen Sie jeder Anfrage den Header Authorization hinzu. Cookies werden nicht akzeptiert, und das Token kann nicht in der URL übergeben werden.

curl -H "Authorization: Bearer pxn_live_…" \
  https://api.proxynet.io/api/v1/me

Zum Erstellen von Tokens und zu Berechtigungen siehe die Seiten Authentifizierung und Tokens und Berechtigungen.

Antwortformat

Erfolgreiche Antworten liefern die Daten unter data; Listen tragen die Paginierungsangaben unter meta.

{
  "data": [ … ],
  "meta": { "total": 6, "limit": 25, "offset": 0, "has_more": false }
}

Fehler kommen an jedem Endpoint im selben Format zurück; verzweigen Sie anhand des Felds code, nicht anhand des Meldungstexts. Alle Codes stehen auf der Seite Fehler.

Endpoints

Die Endpoints sind in der Reihenfolge des Lebenszyklus einer Bestellung angeordnet: Prüfen Sie zuerst im Katalog, was Sie kaufen können, geben Sie dann eineBestellung auf und überwachen Sie den neuen Dienst über die Seiten seines Produkts.

Organisation

• GET/meToken- und Organisationsinformationen · Liefert Gültigkeit und Berechtigungen des Tokens, die zugehörige Organisation, die Stufe, das Guthaben und das Rate Limit.

Katalog und Preise

• GET/catalogKatalog · Liefert in einer Antwort alles, was Sie kaufen können, mit den Preisen Ihrer Stufe.
• GET/locationsStandorte · Liefert die wählbaren Standorte und den aktuellen Bestand.
• GET/target-urlsZiel-Domains · Liefert die Domains, die im Zielmodus wählbar sind.
• GET/stockBestandsprüfung · Führt dieselbe Bestandsprüfung aus wie das Erstellen einer Bestellung.
• GET/pricingPreisangebot · Berechnet den Betrag, der für einen Typ, eine Menge und Zusatzoptionen abgebucht würde.

Bestellungen

• GET/ordersBestellliste · Listet die Proxy-Dienste der Organisation auf; alle fünf Typen kommen gemeinsam.
• POST/ordersBestellung aufgeben · Gibt dieselbe Bestellung auf wie das Panel und bucht den Betrag von Ihrem Guthaben ab.
• GET/orders/{id}Bestelldetails · Liefert Status, verbleibende Tage und Nutzungszähler eines einzelnen Dienstes.

Endpoints nach Produkt

Die Pfade sind bei allen Produkten gleich (/orders/…); die Produktseiten beschränken Body und Beispiele auf die Felder des jeweiligen Produkts. Um zum selben Vorgang bei einem anderen Produkt zu wechseln, nutzen Sie das Menü links.

Bei Produkten pro IP werden Standort und Anzahl gewählt, und der Dienst wird in Zeiträumen von 30 Tagen verlängert; bei Produkten pro GB gibt es eine einzige Gateway-Adresse, das Targeting nach Land und Stadt erfolgt über den Endpoint-Generator, und die Nutzung wird pro GB vom Guthaben abgebucht.