⚡ Begrenzter Vorrat — Nur wenige Router verfügbar. Nächste Lieferung in 2 Wochen.

API-Dokumentation

Automatisieren Sie die IP-Adressen-Rotation über Ihre eigenen Scraping-Skripte.

Authentifizierung

Alle Anfragen an die API erfordern einen gültigen API-Schlüssel. Sie können einen Schlüssel in Ihrem Kundenbereich (Reiter „API-Schlüssel“) generieren. Die Authentifizierung erfolgt über den HTTP-Header Authorization mit dem Bearer-Schema.

Authorization: Bearer ps_live_xxxxxxxxx

IP-Rotation (Erneuerung erzwingen)

POST

Diese Route ermöglicht es Ihnen, die Trennung und anschließende Wiederverbindung Ihres dedizierten Routers mit dem Mobilfunkmast zu erzwingen, wodurch eine neue, frische IP-Adresse bezogen wird. Der Vorgang dauert in der Regel zwischen 3 und 8 Sekunden.

Endpoint
POST https://api.proxym.io/v1/proxies/{assignment_id}/rotate

URL-Parameter

ParameterTypBeschreibung
assignment_idString (UUID)Die eindeutige Kennung Ihres Proxys (zu finden auf dem Dashboard).

Beispielanfrage (cURL)

curl -X POST https://api.proxym.io/v1/proxies/550e8400-e29b-41d4-a716-446655440000/rotate \
  -H "Authorization: Bearer ps_live_abc123..." \
  -H "Content-Type: application/json"

Antwort (Erfolgreich - 200 OK)

{
  "success": true,
  "message": "IP rotated successfully. It may take up to 10 seconds to stabilize."
}
Nutzungslimits (Rate Limiting)

Um die Hardware (Modems) zu schonen und Mobilfunküberlastungen zu vermeiden, gelten strenge Grenzwerte:

  • Maximal 1 Rotation alle 60 Sekunden pro physischem Port.
  • Jede weitere Anfrage innerhalb dieses Zeitraums gibt einen HTTP-Fehler 429 Too Many Requests zurück.