Intégrations et partenariats techniques
L'API Weli n'est pas ouverte au public, et ne l'est pas encore par choix. Elle est documentée en interne et réservée à nos propres applications ainsi qu'aux partenaires dont l'intégration a été validée.
Cette page dit ce qu'elle est et comment en faire la demande. Elle ne donne ni schéma, ni clé, ni documentation de référence.
Une seule porte d'entrée
Toutes les applications Weli passent par une passerelle unique :
api.welispace.com
La passerelle répartit les appels par chemin : le portefeuille, la boutique, les offres d'emploi et les courses ont chacun le leur, derrière cette seule adresse. Le détail des chemins n'est pas public.
L'authentification
Tous les appels authentifiés passent par le système d'identification Weli, conforme au standard OpenID Connect. Les partenaires validés reçoivent l'adresse de l'émetteur et la configuration à utiliser ; elles ne sont pas publiées ici.
Deux modes d'accès
- Accès utilisateur final (application web ou mobile) : vous obtenez un jeton après connexion via la page Weli. Votre application Weli déjà authentifiée peut ensuite appeler l'API avec le même jeton.
- Accès de service (machine à machine) : pour un serveur ou une intégration partenaire, un identifiant dédié est créé après examen de la demande. Il n'existe pas de libre-service.
Demander un accès
Il n'y a pas de portail d'inscription, et il n'en est pas prévu à court terme. Les demandes sont examinées une par une. Adressez la vôtre avec :
- le nom de votre structure ;
- l'usage prévu de l'API ;
- la liste approximative des domaines à consommer (WeliPay, WeliLo, WeliJobs, WeliFlow, etc.) ;
- une adresse de contact.
Envoyez votre demande à [email protected], en objet « Intégration technique ». Nous ne garantissons pas de délai de réponse.
Une fois votre demande acceptée :
- vous recevez un identifiant d'application et, selon le cas, un secret ;
- vous configurez vos URLs de rappel autorisées ;
- vous récupérez la configuration OpenID Discovery.
Documentation
La documentation de référence — paramètres, codes de réponse, champs — existe et est tenue à jour en interne. Elle est remise aux partenaires dont l'accès a été validé. Aucune version publique n'est publiée.
Limites et quotas
La passerelle limite le nombre d'appels par minute, et un dépassement reçoit une réponse « trop de requêtes ». Les seuils d'un partenaire sont fixés au cas par cas, à la validation de l'accès, et inscrits dans la convention qui le lie à nous ; ils ne sont pas publiés.
Webhooks
Des notifications sortantes — Weli appelle votre serveur quand un événement survient, par exemple un paiement validé ou un billet scanné — peuvent être mises en place pour un partenaire. Le périmètre et le format sont définis avec lui, au cas par cas.
Signalement de faille de sécurité
Si vous découvrez une vulnérabilité dans l'API ou dans une application Weli, merci de ne pas l'exposer publiquement. Écrivez à [email protected] ; la procédure complète est décrite en page /securite.
Rétro-compatibilité
L'API est versionnée par préfixe de chemin. Une version majeure n'est retirée qu'après un préavis écrit de douze mois, adressé à chaque partenaire qui l'utilise.
État de l'API et incidents
Les incidents et les maintenances planifiées sont annoncés depuis WeliSpace, et communiqués directement aux partenaires concernés.