* Aussi agile qu'un singe

Portail API

boosteur d’application

Données maritimes et logistiques précises

issues de nos solutions

API robustes conçues

par une équipe d’experts

Nos magnifiques API

Picture

Questions fréquentes

Qu'est-ce que le portail SoGet API ?

Le portail SoGet API est un portail public accessible en ligne. Il est le premier point d’accès pour la découverte des API SOGET et permet d’interagir avec la documentation commerciale et technique, de fournir des commentaires, d’obtenir des informations, d’abonnement et de paiement, etc. C’est la brochure numérique interactive et une fenêtre sur les offres API de SOGET.

Dans le portail SoGet API vous trouverez, pour chacune des API SOGET, les informations suivantes :

  • une présentation de l’API ;
  • un accès au portail développeur qui est un portail accessible en ligne pour nos utilisateurs authentifiés et autorisés. Il contient la documentation technique des services exposés par l’API ;
  • un portail de facturation qui gère le paiement et la facturation des API ;
  • la liste des mises à jour effectués depuis sa publication ;
  • etc.

Quels sont les étapes pour utiliser une API ?

SoGet API vous permet d’utiliser les APIs exposées selon le mode de souscription que vous allez choisir. Pour cela vous devez réaliser les étapes suivantes :

  1. Créer une société. Vous pouvez ensuite ajouter des membres susceptibles d’accéder à cette société selon les droits que vous leur accordez.
  2. Créer une application. Vous pouvez ainsi obtenir vos premiers identifiants d’accès qui prennent la forme d’un couple identifiant / clé secrète. Ces premiers identifiants d’accès vous permettent de générer un « access token » (un jeton individuel d’accès qui permet d’authentifier l’appel à l’API).
  3. Souscrire à une API. Vous pouvez ensuite générer une clé API pour cette API.
  4. Générer une clé API. Vous pouvez ainsi obtenir à votre deuxième identifiant d’accès à l’API à laquelle vous venez de souscrire.

Concrètement, les étapes 2 et 3 sont les étapes de l’authentification de l’utilisateur. Nous utilisons le principe d’une double authentification pour générer vos identifiants d’accès qui prennent la forme suivante :
  • Etape 2 : Authentification de l’application (via le protocole OAuth2).
  • Etape 3 : Authentification de l’entité à facturer (Via une clé API)

Quels sont les différents rôles disponibles pour les utilisateurs de SoGet API ?

Droit « Lecteur » : accède uniquement en lecture aux informations du portail et peut donc :

  • Accéder à la documentation
  • Accéder en lecture aux informations sociétés
  • Accéder en lecture à la liste des API exposées
  • Accéder en lecture à la liste des offres commerciales / abonnements
  • Changer son mot de passe
Droit « Editeur » : possède les droits d’un utilisateur « Lecteur » et peut de plus :
  • Gérer les applications
  • Gérer les clés API
Droit « Propriétaire » : possède les droits d’un utilisateur « Editeur » et peut de plus :
  • Effectuer les transactions
  • Gérer les offres commerciales (souscrire, modifier, supprimer)
  • Consulter les factures

Comment souscrire à une API ?

1. Sélectionnez l’API et l’offre à laquelle vous souhaitez souscrire. Les différentes offres sont affichées dans la page de présentation de l’API.

2. Cliquez sur le bouton « souscrire », vous serez ensuite automatiquement redirigé vers le formulaire de souscription.

3. Soumettez le formulaire.

4. Vous serez ensuite redirigé vers le portail de facturation. Vous devez remplir le formulaire et le soumettre.

5. Une fois la souscription validée, vous pouvez commencer à utiliser l’API !

J’utilise déjà des EDI, quelles sont les différences avec les API ?

Les API sont des interfaces de programmation, accessibles depuis le net, qui permettent aux applications de communiquer entre elles. Ce mode d’échange est beaucoup plus souple, et plus évolutif que l’utilisation des EDI.

Picture

L’interconnexion des systèmes d’informations à grande échelle

Grâce aux API, SOGET vous ouvre l’accès à ses ressources sans sacrifier le contrôle et la sécurité. Intégrez les systèmes de SOGET dans vos outils, pour un accès plus rapide et facile aux données essentielles dans vos prises de décisions quotidiennes.

Gérer le consentement aux cookies

Nous utilisons des cookies pour optimiser notre site web et notre service.

Fonctionnel Toujours activé

Le stockage ou l’accès technique est strictement nécessaire dans la finalité d’intérêt légitime de permettre l’utilisation d’un service spécifique explicitement demandé par l’abonné ou l’utilisateur, ou dans le seul but d’effectuer la transmission d’une communication sur un réseau de communications électroniques.