API publique Pesia — Guide partenaire

Bienvenue dans la documentation officielle de l'API publique Pesia.

Cette API permet aux partenaires d'accéder aux données de paie, d'organisation et de conformité gérées par Pesia pour les agences d'intérim clientes.

URL de base

https://api.pesia.fr/partner/v1/

Format des réponses

Toutes les réponses de succès partagent la même enveloppe { "success", "data", "timestamp" }.

Ressource unique — la ressource est directement sous data :

{ "success": true, "data": { "…": "…" }, "timestamp": "2026-08-10T12:00:00.000Z" }

Collection — les éléments sont sous data.items, avec un bloc de pagination data.meta :

{
  "success": true,
  "data": {
    "items": [{ "…": "…" }],
    "meta": { "total": 1, "page": 1, "limit": 1 }
  },
  "timestamp": "2026-08-10T12:00:00.000Z"
}

Les erreurs ne portent pas cette enveloppe : elles suivent le format application/problem+json (RFC 7807) au premier niveau — voir les sections « Erreurs » de chaque page.

Spec OpenAPI

Téléchargez la spécification OpenAPI complète au format YAML :

• /partner/v1.yaml — spec téléchargeable (auto-synchronisée depuis la source canonique)

Swagger UI interactif (sandbox)

Le Swagger interactif de l'API v1 est disponible sur /partner/v1/docs lorsqu'un service sandbox est proposé. Demandez son URL à partenaires@pesia.fr. Le header X-Pesia-Env: sandbox n'active pas ce Swagger sur un service de production.

Cette documentation fournit la spécification téléchargeable. Voir Sandbox pour les identifiants et les tests de dépôt DPAE.

Contenu de cette documentation

Page	Description
Authentification	OAuth2 Client Credentials — obtenir et utiliser un access token JWT
Scopes	Catalogue des scopes (6 actifs + 7 différés)
Idempotence	Header Idempotency-Key — Mode A, replay, conflit
Versioning	Versioning path-major, headers Sunset + X-Pesia-Deprecation
Stabilité du contrat	Politique additive-only, runway 6 mois
Webhooks	Signature HMAC, 8 événements v1, anti-replay
Sandbox	Accès sandbox, rate limit, banc de conformité DPAE
DPAE	Déposer des DPAE en lot et suivre leur statut — scope dpae:write
Lots de paie	Soumettre les missions d'une période pour le calcul des bulletins — scope payroll:simulate
Codes PCS-ESE	Codes PCS-ESE acceptés par les lots de paie, aussi lisibles par l'API — scope payroll:simulate

Premiers pas

1. Obtenir vos identifiants — contactez votre interlocuteur Pesia (partenaires@pesia.fr).
2. Obtenir un access token — voir Authentification.
3. Choisir vos scopes — voir Scopes.
4. Tester en sandbox — voir Sandbox.

Support

• Email : partenaires@pesia.fr
• Statut : https://status.pesia.fr