Reliez vos systèmes à Ultineo
L’API de chaque produit, un guide par tâche, les intégrations et les outils, et la documentation de référence : ce qui est écrit pour ceux qui construisent.
Choisissez votre point de départ
- API E-commerce
Une API JSON sur HTTPS pour la boutique que vous tenez avec Ultineo E-commerce. Un script de migration, une synchronisation avec votre ERP ou un flux fournisseur envoie des éléments par lots, et relit n'importe quel élément pour vérifier ce qui a été enregistré.
- API Ultineo Reasoning
Lancez vos raisonnements depuis vos logiciels.
- API de projet Ultineo SaaS
Une option d'un projet Ultineo SaaS, qui n'accompagne pas chaque application. Sa disponibilité et son prix figurent dans l'offre du projet, et elle expose les opérations convenues pour ce projet.
Un premier appel, et sa réponse
L’exemple du premier guide, tel que la documentation de référence de l’API E-commerce le publie.
Requête
curl "https://api.ultineo.com/v1/category/import?name=Smartphones" \
-H "Authorization: Bearer sk-project-YOUR_KEY" La clé circule dans l’en-tête Authorization, après le mot Bearer.
Réponse
{
"code": 200,
"title": "OK",
"response": {
"object": "category",
"id": "cate_4be1a07f93c2d58e6a10",
"name": "Smartphones",
...
"status": "activated",
...
"created_at": 1789143990,
"updated_at": 1789143990
}
} L’enveloppe contient code, title et response, et response contient ici la catégorie.
API
L’API de chaque produit, et ce que couvre chacune de ses parties.
- API E-commerce
Créer un accès API et échanger les données de votre boutique
- Catalogue, commandes et bons de réduction
Ce qu’un programme envoie et relit pour chaque ressource du catalogue, de l’historique des ventes et des bons de réduction.
- Colis, adresses et transporteurs
L’API d’Ultineo Logistics : suivre des colis, tenir un carnet d’adresses à jour et lire le catalogue des transporteurs.
- API Ultineo Reasoning
Lancez vos raisonnements depuis vos logiciels.
- API de projet Ultineo SaaS
Examinez le périmètre API d’un projet éligible et distinguez les routes prévues des endpoints déjà construits.
Guides
Une tâche par guide, du premier appel à une connexion quotidienne.
- Faire votre premier appel
L’adresse, le contrôle de disponibilité, la clé dans l’en-tête et la lecture de la réponse d’un premier appel.
- Gérer les clés et les accès
Qui crée une clé, ce qu’elle peut atteindre, quand elle expire et comment la renommer, la désactiver ou la supprimer.
- Importer par lots
Le contrat commun à tous les imports : lots, mode essai, renvoi sans doublon et rapport.
- Gérer les erreurs et les limites
Ce que chaque statut de l’API demande à votre programme, et ce que vous pouvez renvoyer sans risque.
- Relier un ERP ou un flux fournisseur
Une connexion type depuis un autre système : clés à faire correspondre, premier essai, synchronisation et contrôles.
- Migrer une boutique existante
Reprenez le catalogue, l’historique de ventes et le domaine de votre boutique, en vérifiant chaque étape.
- L’IA dans vos logiciels
Un raisonnement ajouté à un écran de votre logiciel, lancé par l’API puis relu par votre code.
Intégrations et outils
Ce qui se relie sans code : services, fichiers, noms de domaine et projets logiciels.
- Intégrations
Les services qu’une boutique connecte, l’état de chacun et les connexions externes d’un projet logiciel.
- Flux produits
Flux produits pour les services d’achat
- Imports et exports par fichier
Le catalogue par fichiers avec un compte rendu par ligne, et les autres échanges par fichier d’une boutique.
- Noms de domaine
Connectez votre domaine à une boutique ou à un projet logiciel : preuve de propriété, DNS, contrôles.
- Projets logiciels
L’option API de projet, les connexions externes, les environnements et les versions d’un logiciel sur mesure.
Ressources
La documentation de référence, les conventions, la sécurité, l’état des services, les nouveautés et l’aide.
- Référence de l’API E-commerce
Tous les articles de l’API E-commerce, dans le centre d’aide.
- Conventions de l’API
Les règles communes à toutes les routes : JSON sur HTTPS, une enveloppe, identifiants, dates, montants et listes.
- Sécurité
Comment les clés, les connexions chiffrées et les accès de l’équipe protègent ce qu’atteint votre intégration.
- État des services
L'état actuel de nos services
- Nouveautés
Ce qui a changé dans les produits
- Aide aux développeurs
Où un développeur ou un intégrateur trouve une réponse, quoi vérifier d’abord et quoi nous envoyer.
Ouvrez votre boutique, puis connectez-la
Une clé se crée dans une boutique ouverte. Les comptes sont ouverts après étude : envoyez votre demande, et notre équipe vous répond par e-mail.
Questions de développeurs
Un administrateur du projet de votre boutique la crée dans l'espace de travail, dans l'onglet « Accès API ». Sa valeur complète est affichée une seule fois : copiez-la dès sa création. Il vous faut d'abord une boutique ouverte, et les comptes sont ouverts après étude.
Oui, pour les imports. Envoyez le lot en mode essai, avec dry_run à true : vous obtenez le rapport complet de ce qui serait créé, mis à jour, laissé inchangé ou refusé, et rien n'est écrit. Vérifiez le champ dry_run de la réponse avant de vous fier à un rapport.
Le catalogue, l'historique des ventes et les bons de réduction ; les colis, les adresses et les transporteurs relèvent de l’API d’Ultineo Logistics. L'article « Votre premier appel » liste chaque ressource avec ses droits. Ne supposez pas que chaque écran de l'espace de travail possède un point d'accès équivalent.
Un appel en échec utilise la même enveloppe qu'un appel réussi : lisez le code de statut HTTP, puis le message dans response. Dans un import, chaque élément est vérifié séparément : un élément qui échoue à un contrôle est signalé comme refusé avec ce qu'il faut corriger, et les autres éléments du lot poursuivent leur traitement.
Oui. Chaque ressource a sa propre limite par lot, indiquée dans son article de référence, et le corps d'une requête a une taille maximale. Lorsque trop de requêtes arrivent en peu de temps, l'appel est refusé et l'en-tête Retry-After indique le nombre de secondes à attendre. Renvoyer le même lot ne crée jamais de doublon.
Non. L'API fournit des éléments de connexion, pas un connecteur installé automatiquement. Votre équipe technique ou votre prestataire construit et teste l'échange avec les points d'accès documentés.
Une API de projet est une option d'un projet Ultineo SaaS. Sa disponibilité et son prix figurent dans l'offre du projet, et une application peut fonctionner sans elle. Sa documentation de référence est celle du projet pour lequel elle est activée.
Dans le centre d'aide E-commerce, à la rubrique consacrée à l'API E-commerce. Elle est publique, rédigée en anglais et en français, et se lit sans compte.