Skip to main content

API-Schlüssel

Für die Authentifizierung muss der Header pubrio-api-key enthalten sein. Der Header sollte den API-Schlüssel enthalten, zum Beispiel a1b2c3d4e5f6g7h8, der Ihren API-Schlüssel repräsentiert.
Sie müssen einen API-Schlüssel erstellen, um auf die Pubrio API zugreifen zu können. Dies können Sie im Bereich Einstellungen tun.
Der API-Schlüssel enthält bereits Ihre Workspace-Informationen (Profil), sodass Sie profile_id nicht in Ihrem Request-Body angeben müssen. Der Parameter profile_id wird aus Gründen der Abwärtskompatibilität weiterhin akzeptiert, ist aber nicht mehr erforderlich.

Request-Header

Senden Sie zusammen mit pubrio-api-key einen User-Agent-Header, der Ihren Client identifiziert.
Ein fehlender oder generischer User-Agent wird abgelehnt, bevor die Anfrage die API erreicht. Anfragen ohne erkannten User-Agent werden bereits am Edge blockiert und liefern HTTP 403 mit dem Klartext-Body error code: 1010 zurück — nicht JSON und keinen der dokumentierten Fehlercodes. Dies sieht wie ein Authentifizierungsfehler aus, ist aber keiner: Ihr API-Schlüssel ist in Ordnung.Standard-User-Agents gängiger HTTP-Bibliotheken sind betroffen — der von Pythons urllib (Python-urllib/3.x) wird blockiert, während curl und requests nicht betroffen sind. Falls Sie error code: 1010 erhalten, setzen Sie einen expliziten User-Agent und versuchen Sie es erneut.