OpcoviaProxy intelligent pour les APIs OPCO

Normalisez, cachez et orchestrez vos appels API Convergence en toute simplicite.

Guide de demarrage

Reference API

Normalisation des echanges

Transforme les requetes et reponses entre votre logiciel CFA et chaque OPCO via des profils DSL declaratifs.

POST asynchrone (202)

Les ecritures (dossiers, factures, conventions) sont traitees via une queue BullMQ avec suivi de job en temps reel.

Cache intelligent

Cache Redis avec TTL configurable. Les lectures repetees sont servies instantanement sans solliciter l'OPCO.

Webhooks push

Recevez des notifications signees HMAC-SHA256 quand un dossier change d'etat, qu'une facture est traitee, ou qu'un sync progresse.

Bulk sync

Synchronisez tous les dossiers d'un CFA en un seul appel. Discovery + fetch par batches de 50 avec progression en temps reel.

Hub multi-instance

Coordonnez le rate limiting entre plusieurs instances Opcovia via un Hub centralise en WebSocket.

Pourquoi Opcovia ?

Les editeurs de logiciels CFA doivent integrer les APIs OPCO (API Convergence) pour transmettre des contrats d'apprentissage, factures et conventions. Chaque OPCO a ses particularites, ses limites de debit, et ses formats specifiques.

Opcovia se place entre votre logiciel et les OPCOs pour :

Unifier l'interface -- une seule API, quel que soit l'OPCO cible
Gerer la complexite -- rate limiting, retry, cache, OAuth2 automatique
Fiabiliser les echanges -- idempotence, audit trail, webhooks