Pour les développeurs
Connectez votre SIRH et votre ATS à Paritir
L’API d’intégration permet à vos systèmes d’envoyer régulièrement à Paritir les données salariés et les offres d’emploi. L’analyse de l’écart de rémunération tourne ainsi sur des données à jour, sans import CSV manuel. Elle s’adresse à ceux qui réalisent l’intégration : un cabinet de conseil, l’équipe informatique du client ou les ingénieurs de Paritir.
Ce qu’elle fait
Trois tâches, une API
Salariés par lots
Envoyez les fiches salariés par lots. Paritir rapproche chaque fiche par votre identifiant externe, sinon par l’e-mail, met à jour ce qui a changé et en déduit l’historique des salaires et des postes. Vous n’envoyez jamais d’historique vous-même.
Associez vos champs une fois
Envoyez quelques lignes d’exemple et Paritir propose une correspondance entre les champs de votre SIRH et les siens. Une personne la valide une fois, puis elle est enregistrée comme profil de source. Les synchronisations suivantes l’appliquent telle quelle et retiennent un lot si la structure de votre source change.
Les offres entrent, la conformité ressort
Envoyez les offres d’emploi de votre ATS. Paritir vérifie chacune au regard des règles de transparence salariale du pays de votre siège, et vous pouvez relire le résultat pour chaque offre.
Accès
OAuth 2.0, limité à une organisation
Client credentials
Votre système échange un identifiant client et un secret contre un jeton d’accès. Les jetons valent 15 minutes ; demandez-en un nouveau à l’expiration. Il n’existe pas de clé d’API statique.
Une organisation par identifiant
Un jeton ne lit et n’écrit que dans l’organisation qui a émis son identifiant. L’organisation vient de l’identifiant, jamais de la requête.
Seuls les scopes accordés
Chaque identifiant porte les scopes choisis à sa création, comme écrire des salariés ou lire des offres. Un appel hors de ces scopes est refusé.
Créés et révoqués dans l’application
Le propriétaire (Owner) ou un administrateur (Admin) de l’organisation crée les identifiants dans Paramètres → Intégrations. Le secret s’affiche une seule fois et n’est conservé que sous forme de hachage. Révoquer un identifiant bloque aussitôt ses jetons.
Obtenir un jeton, puis envoyer un lot
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, … }Référence
Les points d’accès disponibles aujourd’hui
Requêtes et réponses sont en JSON. Chaque appel est journalisé pour votre organisation.
URL de base https://app.paritir.com/v1
| Méthode | Chemin | Scope | Rôle |
|---|---|---|---|
| POST | /oauth/token | — | Échanger les identifiants client contre un jeton d’accès de 15 minutes. |
| POST | /employees:batch | workforce:write | Créer ou mettre à jour des salariés en un lot. |
| POST | /employees:map-preview | workforce:write | Proposer une correspondance de champs à partir de lignes d’exemple. N’écrit rien. |
| POST | /postings:batch | postings:write | Créer ou mettre à jour des offres d’emploi en un lot. |
| GET | /postings | postings:read | Lister les offres avec leur résultat de conformité, les plus récentes d’abord. |
| GET | /postings/{posting_reference} | postings:read | Lire une offre à partir de votre propre référence. |
Renvoi sans risque
Joignez un en-tête Idempotency-Key à chaque lot. La même clé renvoie le premier résultat sans écrire à nouveau ; si le traitement est encore en cours, la réponse est HTTP 409.
Pagination et filtres
La liste des offres se pagine avec limit et un cursor opaque, et se filtre par status et par updated_since.
Erreurs et limites
Les erreurs arrivent en JSON avec un message. La validation nomme les champs en cause sans jamais répéter les valeurs envoyées. Les appels sont limités par organisation ; au-delà, la réponse est HTTP 429.
État
Ce que l’API ne fait pas encore
L’API fait entrer les données et sortir les offres d’emploi. Les résultats d’écart de rémunération, les rapports et les évaluations conjointes des rémunérations restent pour l’instant dans l’application. Il n’y a pas encore de webhooks ni d’environnement sandbox : une nouvelle intégration se met donc en place sur une organisation réelle, avec notre aide.
L’accès à l’API passe par un compte
Paritir fonctionne sur invitation pendant que nous travaillons avec nos premiers clients et cabinets de conseil. Une fois votre organisation créée, son propriétaire ou un administrateur peut créer des identifiants d’API.