Environnements et URL de base
URL de base de l'API
L'API de la plateforme est accessible sur l'hôte destiné aux locataires, sous /api/trpc :
https://manage.inklura.fr/api/trpc/<router>.<procedure>
manage.inklura.fr est un endpoint unique et véritablement multi-locataire : votre locataire
voyage dans votre token Bearer, de sorte que la même URL
sert tous les locataires — le serveur lit tenantId/siteId directement dans le token signé.
Un locataire donné peut aussi atteindre l'API via son propre domaine, où le Host identifie
le locataire pour les requêtes par cookie de session. Voir Tenancy.
| Environnement | Base de l'API |
|---|---|
| Production | https://manage.inklura.fr/api/trpc |
| Dev local (company-manager) | http://localhost:3060/api/trpc |
Il existe une copie interne, à haut débit et accessible uniquement en loopback, du même router
(le serveur « lean ») que la console utilise à l'adresse http://127.0.0.1:4000/api/trpc. Elle
n'est pas joignable hors de l'hôte et n'est pas un endpoint public — appelez toujours l'hôte
public depuis votre propre code.
Le pont REST /api/v1
Un pont REST/OpenAPI existe à l'adresse /api/v1/<router>/<procedure>, généré à partir des
routers tRPC. Aujourd'hui, il n'est que partiellement câblé — une procédure n'apparaît sous
/api/v1 que si elle a été explicitement annotée avec des métadonnées OpenAPI, ce qui couvre
actuellement un petit nombre d'opérations users/products. Considérez REST comme
expérimental ; pour tout le reste, utilisez tRPC. Voir
Endpoints REST.
Applications de la plateforme
Inklura est une famille d'applications partageant une même connexion. Celles qui intéressent les développeurs :
| Application | Hôte | Ce que c'est |
|---|---|---|
| Console | manage.inklura.fr |
L'application d'administration + l'API de la plateforme |
| SMS Designer | smsdesigner.inklura.fr |
Compositeur et rapports de campagnes SMS |
| SEO | seo.inklura.fr |
Audits SEO et rapports clients |
mail.inklura.fr |
Compositeur e-mail/MJML | |
| Wiki | wiki.inklura.fr |
Bibliothèque de guides à accès restreint |
| Fournisseur d'identité | auth.1clic.pro |
OIDC / SSO |
Chaque hôte *.inklura.fr résout vers le même edge et partage le cookie de session ; ainsi un
utilisateur connecté une fois est authentifié sur toutes ces applications. Voir
SSO.
TLS et DNS
*.inklura.fr résout vers l'edge de la plateforme. Chaque hôte est servi en HTTPS avec un
certificat par domaine que la plateforme provisionne et renouvelle automatiquement (ACME
HTTP-01). Ajouter un nouveau sous-domaine ne requiert aucune modification DNS de votre côté —
voir Provisionnement de sous-domaines.