Für Entwickler
Verbinden Sie Ihr HRIS und ATS mit Paritir
Über die Integrations-API senden Ihre Systeme Beschäftigten- und Stellenanzeigendaten regelmäßig an Paritir. So läuft die Analyse des Entgeltgefälles auf aktuellen Daten, ohne manuellen CSV-Import. Gebaut ist sie für alle, die die Integration umsetzen: eine Beratung, die IT des Kunden oder das Engineering-Team von Paritir.
Was sie leistet
Drei Aufgaben, eine API
Beschäftigte im Batch
Senden Sie Beschäftigtendaten in Batches. Paritir ordnet jeden Datensatz über Ihre externe ID zu, sonst über die E-Mail-Adresse, übernimmt Änderungen und leitet daraus die Gehalts- und Rollenhistorie ab. Historie senden Sie nie selbst.
Felder einmal zuordnen
Senden Sie einige Beispielzeilen, und Paritir schlägt vor, wie Ihre HRIS-Felder den eigenen zugeordnet werden. Ein Mensch bestätigt die Zuordnung einmal, sie wird als Quellprofil gespeichert. Spätere Synchronisierungen wenden sie unverändert an und halten einen Batch zurück, wenn sich die Struktur Ihrer Quelle ändert.
Anzeigen rein, Prüfergebnis raus
Senden Sie Stellenanzeigen aus Ihrem ATS. Paritir prüft jede gegen die Entgelttransparenzregeln des Landes Ihres Hauptsitzes, und Sie können das Ergebnis für jede Anzeige abrufen.
Zugang
OAuth 2.0, beschränkt auf eine Organisation
Client Credentials
Ihr System tauscht eine Client-ID und ein Secret gegen ein Zugriffstoken. Tokens gelten 15 Minuten; danach fordern Sie ein neues an. Statische API-Schlüssel gibt es nicht.
Eine Organisation pro Zugang
Ein Token liest und schreibt nur die Organisation, die den Zugang ausgestellt hat. Die Organisation ergibt sich aus dem Zugang, nie aus der Anfrage.
Nur die erteilten Scopes
Jeder Zugang trägt die Scopes, die bei der Anlage gewählt wurden, etwa Beschäftigte schreiben oder Anzeigen lesen. Aufrufe außerhalb davon werden abgelehnt.
In der App angelegt und widerrufen
Owner oder Admin einer Organisation legen Zugänge unter Einstellungen → Integrationen an. Das Secret wird einmal angezeigt und nur als Hash gespeichert. Ein widerrufener Zugang sperrt seine Tokens sofort.
Token holen, dann einen Batch senden
POST https://app.paritir.com/v1/oauth/token
Content-Type: application/json
{ "grant_type": "client_credentials",
"client_id": "ptir_…", "client_secret": "…" }
→ { "access_token": "…", "token_type": "Bearer",
"expires_in": 900, "scope": "workforce:write" }POST https://app.paritir.com/v1/employees:batch
Authorization: Bearer …
Idempotency-Key: …
Content-Type: application/json
{ "employees": [
{ "external_id": "E-1042", "full_name": "…", "email": "…" }
] }
→ { "sync_run_id": "…", "inserted": 1, "updated": 0,
"unchanged": 0, "errors": 0, … }Referenz
Die Endpunkte, die heute live sind
Anfragen und Antworten sind JSON. Jeder Aufruf wird für Ihre Organisation protokolliert.
Basis-URL https://app.paritir.com/v1
| Methode | Pfad | Scope | Zweck |
|---|---|---|---|
| POST | /oauth/token | — | Client Credentials gegen ein 15-Minuten-Zugriffstoken tauschen. |
| POST | /employees:batch | workforce:write | Beschäftigte in einem Batch anlegen oder aktualisieren. |
| POST | /employees:map-preview | workforce:write | Aus Beispielzeilen eine Feldzuordnung vorschlagen. Schreibt nichts. |
| POST | /postings:batch | postings:write | Stellenanzeigen in einem Batch anlegen oder aktualisieren. |
| GET | /postings | postings:read | Anzeigen mit Prüfergebnis auflisten, neueste zuerst. |
| GET | /postings/{posting_reference} | postings:read | Eine Anzeige über Ihre eigene Referenz abrufen. |
Gefahrlos wiederholbar
Senden Sie mit einem Batch den Header Idempotency-Key. Derselbe Schlüssel liefert das erste Ergebnis, ohne erneut zu schreiben; läuft der Vorgang noch, kommt HTTP 409.
Seiten und Filter
Die Anzeigenliste blättert mit limit und einem undurchsichtigen cursor und filtert nach status und updated_since.
Fehler und Limits
Fehler kommen als JSON mit einer Meldung. Validierungsfehler nennen die betroffenen Felder und wiederholen nie die gesendeten Werte. Aufrufe sind pro Organisation begrenzt; darüber gibt es HTTP 429.
Stand
Was die API noch nicht kann
Die API bringt Daten hinein und Stellenanzeigen heraus. Ergebnisse zum Entgeltgefälle, Berichte und gemeinsame Entgeltbewertungen bleiben vorerst in der App. Webhooks und eine Sandbox gibt es noch nicht; eine neue Integration wird daher mit unserer Hilfe gegen eine echte Organisation eingerichtet.
API-Zugang gibt es mit einem Konto
Paritir ist nur auf Einladung zugänglich, solange wir mit unseren ersten Kunden und Beratungen arbeiten. Ist Ihre Organisation eingerichtet, können Owner oder Admin API-Zugänge anlegen.