SonetSuite API

Services, accès & documentation

SonetSuite, met à disposition de ses partenaires une API leur permettant un pilotage de leurs contenus et ceux de leurs clients. Ces contenus peuvent être visibles sur l'ensemble des plateformes éditées;

Plateforme & domaine

La plateforme cible des appels à l'API SonetSuite est comme suit :

https://sn1.io

Protocoles de communication

Pré-requis

Pour utiliser une API, vous devez au préalable avoir :

  • été déclaré comme partenaire de l'API
  • demandé un accès API afin d'obtenir les identifiants client et une clé secrète

Identifiants

Un identifiant client et une clé secrète vous sont délivrés par nos services lorsque vous souscrivez à nos API.

Conservez précieusement ces informations nécessaires pour requêter les API.
Veillez à protéger votre identifiant client et clé secrète en suivant ces bonnes pratiques :

  • Ne faites pas figurer vos identifiants en clair dans le code source
  • Lorsque vous publiez du code sur une plateforme de gestion de versions, assurez-vous que vos identifiants n'apparaissent pas en clair
  • La clé secrète doit être uniquement présente sur la partie serveur de votre application

Protocoles et standards

  • Les API exposées respectent les contraintes de l'architecture REST
  • Les API sont sécurisées via le protocole OAuth 2.0
  • OAuth 2.0 impose l'utilisation du protocole web HTTPS (TLS V1.2 minimum) pour tous les échanges effectués
  • Les ressources sont recéptionnés au format JSON
  • Les ressources sont distribuées au format JSON

SonetSuite API Services Management

Il s'agit d'un dispositif d'autorisation basé sur le protocole OAuth 2.0. Il apporte les fonctionnalités suivantes :

  • un mécanisme d'authentification unique sur l'ensemble des services SonetSuite,
  • un moyen d'obtenir des informations sur les informations de vos clients.

La solution se décline en trois domaines, chacun adressant un type service :

UsageURLDomaine
Gestion globale des clients/mps/partnerpartner
References & catégories/mps/referencereference
Entreprises/mps/companycompany
Offres d'emploi/mps/offerjoboffer

Entête des appels à l'API SonetSuite

Paramètres des appels à l'API :

  • Accept : application/json;charset=UTF-8
  • Authorization : Bearer <your_generated_access_token>
  • Content-Type : application/json;charset=UTF-8