Authentifizierung
Authentifizieren Sie jede Anfrage mit einem Bearer-Token Ihrer Organisation.
Die Authentifizierung erfolgt ausschließlich über den Header Authorization. Cookies werden nicht akzeptiert, und das Token kann nicht in der URL (als Query-Parameter) übergeben werden. Alle Endpoints erwarten denselben Header.
Authorization: Bearer pxn_live_…Bearer , gefolgt vom Token. Anfragen ohne Token oder mit fehlerhaftem Format erhalten 401 unauthorized.
Warum nur der Header
URLs landen in Serverlogs und im Referer-Header; ein Token in der URL würde dort offengelegt. Da keine Cookies akzeptiert werden, entfällt außerdem die Angriffsfläche für Cross-Site Request Forgery (CSRF) vollständig.
Basis-URL
https://api.proxynet.io/api/v1Erste Anfrage
curl -H "Authorization: Bearer pxn_live_…" \
https://api.proxynet.io/api/v1/meDie Antwort enthält den Namen des Tokens, seine Berechtigungen und die Organisation, zu der es gehört. Eine Anfrage an einen Endpoint, für den die Berechtigung fehlt, liefert403 insufficient_scope; welche Berechtigung welche Endpoints freigibt, steht auf der Seite Tokens und Berechtigungen.
Token sicher aufbewahren
- Speichern Sie das Token in einer Umgebungsvariable oder einem Secret-Manager.
- Geben Sie jeder Integration ein eigenes Token; wird eines offengelegt, widerrufen Sie nur dieses.
- Wählen Sie nur die nötigen Berechtigungen. Ein Monitoring-Server braucht die Berechtigung
orders:writenicht. - Das Erstellen und Widerrufen von Tokens erscheint auf der Seite Aktivität der Organisation.
Häufige Fragen
Kann ich das Token in der URL übergeben?
Nein. Ein Query-Parameter wie ?token= wird nicht akzeptiert; gelesen wird nur der Header Authorization.
Kann ich die API aus dem Browser aufrufen?
Nein. Die API erlaubt keine CORS-Aufrufe aus dem Browser. Der Bereich Ausprobieren in dieser Dokumentation sendet Anfragen über unseren eigenen Proxy; in Ihrem eigenen Frontend stellen Sie die Anfrage von Ihrem eigenen Server aus.
Kann ein Token auf mehrere Organisationen zugreifen?
Nein. Ein Token gehört zu der Organisation, in der es erstellt wurde. Für die Dienste einer anderen Organisation erstellen Sie dort ein eigenes Token.