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é.

Faire votre premier appel

Voir la page de l'API

API Ultineo Reasoning

Lancez vos raisonnements depuis vos logiciels.

L’IA dans vos logiciels

Voir la page de l'API

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.

Projets logiciels

Voir la page de l'API de 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.