Logs
Liefert die Verbindungseinträge des Dienstes Gaming Proxy, filterbar und paginiert.
https://api.proxynet.io/api/v1/orders/{id}/logsIhre Stufe muss Log-Zugriff umfassen. Bei ISP, Datacenter und Gaming ist jeder Eintrag eine VERBINDUNG und wird beim Schließen der Verbindung geschrieben; die Bedeutung der Felder steht auf der Seite Log-Einträge. Der neueste Eintrag kommt zuerst.
Jeder Eintrag kommt mit demselben festen Satz an Schlüsseln; ein Feld ohne Wert fehlt nicht, sondern ist null.
Ungültige Filterwerte werden nicht stillschweigend ignoriert, sondern liefern 400 invalid_request. Auch ein unbekannter Parameter, ein Zeitraum, dessen Beginn nach seinem Ende liegt, oder ein ISP-spezifischer Parameter bei einem Mobile/Residential-Dienst liefern 400; details.field nennt den betreffenden Parameter. offset + limit darf 10000 nicht überschreiten.
Ist meta.partial true, kann die Liste unvollständig sein: In der ISP-Familie konnten ältere Einträge in dem Moment nicht gelesen werden, bei Mobile/Residential wurden nur die neuesten Einträge zurückgegeben. Versuchen Sie es etwas später erneut. Ist meta.source none, gibt es für diesen Dienst noch keine Log-Quelle. Ist der Log-Speicher vorübergehend nicht erreichbar, kommt 503 service_unavailable zurück.
Autorisierung
Wird als Bearer <token> gesendet. Dieser Endpoint erfordert die Berechtigung logs:read (Logs); ein Token ohne diese Berechtigung erhält 403.
Pfadparameter
ID des Dienstes. Aus dem Feld id in der Antwort von GET /orders.
Query-Parameter
Level; kann mehrfach gesendet werden. In der ISP-Familie aus dem Ergebniscode abgeleitet: 0 → connect, 100/101 → auth, 105/106 → quota, 201 → disconnect, andere Codes → error. Einträge vor dem 17.09.2026 können nur connect oder error sein.
Freie IP-Suche. Nur Ziffern, a-f, . und : sind erlaubt. In der ISP-Familie trifft eine vollständige IPv4-/IPv6-Adresse exakt auf Client-, Ziel-, Ausgangs- oder Eingangs-IP; ein Teil einer Adresse (z. B. 185.23) muss mindestens 3 Zeichen lang sein und wird in der Zieladresse gesucht (nur Einträge ab dem 17.09.2026). Bei Mobile/Residential wird in der Ziel- oder Client-Adresse gesucht. Für die Suche nach Domains verwenden Sie target_host.
Beginn, ISO-8601. In der ISP-Familie bezogen auf den Zeitpunkt, an dem die Verbindung GESCHLOSSEN wurde, und auf den Erstellungszeitpunkt der Bestellung begrenzt; ältere Einträge kommen nicht zurück.
Ende, ISO-8601. Darf nicht vor dem Beginn liegen.
Untergrenze für die Dauer, die die Verbindung offen war, in ms (nicht negative Ganzzahl). Keine Latenz; für die Latenz gibt es min_latency_ms.
Obergrenze für die Dauer, die die Verbindung offen war, in ms. Darf nicht kleiner als min_duration_ms sein.
Einträge pro Seite: 1-200, Standard 50. 0, negative oder nicht ganzzahlige Werte liefern 400; Werte über 200 werden auf 200 gesetzt (meta.limit zeigt den angewandten Wert).
Anzahl der zu überspringenden Einträge. offset + limit darf 10000 nicht überschreiten; statt tiefer zu blättern, grenzen Sie den Zeitraum mit start/end ein.
ISP-Familie. true nur erfolgreiche, false nur fehlgeschlagene Verbindungen.
ISP-Familie. Ergebniscode, z. B. 105. Wiederholbar oder kommagetrennt. Die Codes stehen auf der Seite Log-Einträge.
ISP-Familie. Ergebniskategorie. Wiederholbar oder kommagetrennt.
ISP-Familie. Findet eine einzelne Verbindung über ihren requestId-Wert (26-stellige ULID).
ISP-Familie. Ihre Client-IP (sourceIp); vollständige IPv4-/IPv6-Adresse, exakte Übereinstimmung.
ISP-Familie. Ausgangs-IP (egressIp); vollständige IPv4-/IPv6-Adresse, exakte Übereinstimmung.
ISP-Familie. Hostname des Ziels oder ein Teil davon (Buchstaben, Ziffern, . und -); ohne Beachtung der Groß-/Kleinschreibung. Mindestens 3 Zeichen; gesucht wird nur in Einträgen ab dem 17.09.2026.
ISP-Familie. Das tatsächlich verwendete Protokoll: http oder socks5.
ISP-Familie. true nur UDP-ASSOCIATE-Einträge; false filtert nicht.
ISP-Familie. Port-Slot-Nummer (1-100000).
ISP-Familie. Der Proxy-Port, mit dem Sie sich verbunden haben (gatePort, 1-65535).
ISP-Familie. Verbindungen mit einer Verbindungslatenz von mindestens so vielen ms (1-3600000). Einträge ohne gemessene Latenz (latencyMs null) werden ausgeschlossen.