Intégrations au Cloud

Les intégrations au Cloud permettent aux développeurs tiers (intégrateurs) d’utiliser nos API Cloud Print et de déclencheur de Cloud pour interagir avec votre système d’impression d’étiquettes.

[Note] Note

Voir des informations complémentaires sur les déclencheurs de Cloud dans le Guide d’utilisation de Automation.

Pour activer des développeurs tiers à l’aide de nos API :

  • Les développeurs tiers doivent s’enregistrer sur notre Portail développeur.

  • Vous devez souscrire vos développeurs tiers dans Control Center.

Pour utiliser les API de déclencheur de Cloud, les API Loftware Cloud et les API Cloud Print, les développeurs tiers doivent inclure les clés de souscription provenant de notre Portail développeur dans les requêtes HTTP avec des entêtes personnalisées « Ocp-Apim-Subscription-Key ».

[Note] Note

Vous n’avez pas besoin de clés d’abonnement si vous utilisez vos API dans des applications Loftware.

Dans Control Center, aller dans Intégrations > Intégrations dans le Cloud pour voir vos intégrations au Cloud actives et inactives.

Pour activer des développeurs tiers afin qu’ils puissent utiliser nos API, vos développeurs ont besoin de vos noms de déclencheur de cloud (uniques à chaque déclencher).

Vos développeurs peuvent également utiliser notre fonction intégrée d’équilibrage des charges avec les déclencheurs de Cloud.

[Note] Note

Vos clés de souscription fonctionnent pour plusieurs développeurs. À des fins de transparence et de sécurité, nous vous conseillons de créer des intégrations au Cloud distinctes pour chaque développeur. Avec cette méthode, vous pouvez révoquer l’accès de développeurs individuels en supprimant leurs intégrations au Cloud respectives, sans affecter l’accès de vos autres développeurs.

Configuration des comptes sur le Portail développeur

Dans Control Center :
  1. Aller dans Intégrations > Intégrations dans le Cloud.

  2. Cliquer sur +Ajouter. La page des Intégrateurs s'ouvre.

  3. Saisir le Nom de votre développeur tiers.

  4. Copier la clé.

  5. Cliquer sur Enregistrer.

Control Center affiche votre nouveau développeur dans la page Intégrations au Cloud avec le statut : Aucun développeur souscrit.

[Note] Note

Votre compte utilisateur Control Center doit avoir le droit de gérer les intégrations au Cloud.

Instructions pour vos développeurs tiers :
  1. Ouvrir le Portail développeur dans votre navigateur.

  2. Cliquer sur S’inscrire. La page des Inscriptions s'ouvre.

  3. Saisir vos informations et cliquer sur S’inscrire.

  4. Aller dans votre messagerie et ouvrir l'e-mail envoyé par le Portail développeur (vérifier dans le Courrier indésirable).

  5. Cliquer sur le lien de confirmation dans l'email. La page de Profil du Portail développeur s'ouvre.

Votre intégrateur est inscrit sur le Portail développeur. Pour utiliser les API, souscrire aux API Cloud Print et connecter les souscriptions à Control Center.

[Note] Note

Pour plus d'informations, lire la section Déclencheurs de Cloud dans votre Guide utilisateur Automation.

Souscription au Loftware Portail développeur

Une fois que vos intégrateurs tiers ont configuré les comptes sur le Portail développeur, ils doivent souscrire aux produits spécifiques pour utiliser leurs API, puis connecter leur souscription à Control Center. Les souscriptions aux produits du Portail développeur sont gratuites et utilisent des clés principales et secondaires pour l'authentification. Par exemple, pour utiliser les API de Control Center, ils doivent souscrire au produit Control Center sur le Portail développeur :

  1. Se connecter au Portail développeur de Loftware.

  2. Aller dans Produits > Loftware Cloud.

  3. Cliquer sur Ajouter une souscription.

  4. Saisir le nom de votre souscription (si vous avez plusieurs clients, choisir les noms spécifiques aux clients).

  5. Cliquer sur Confirmer.

Votre page de profil de développeur s’ouvre avec la boîte de dialogue : Vous avez souscrit au produit Loftware Cloud. Essayer les API dans ce produit maintenant. Votre développeur a souscrit au Portail développeur, mais vous devez connecter sa souscription à Control Center avec qu’il puisse utiliser l’API Cloud Print.

[Note] Note

La souscription génère deux clés différentes. Utilisez-les pour plusieurs versions du programme et pour une sécurité renforcée. Si votre clé principale est compromise, utiliser la clé secondaire et regénérer votre clé principale. Pour plus d'informations, lire la section Déclencheurs de Cloud dans votre Guide utilisateur Automation.

Connecter votre souscription au Portail développeur à Control Center

Une fois que vos développeurs enregistrent et créent des souscriptions sur le Portail développeur, vous devez connecter leurs souscriptions à Control Center avant qu’ils puissent utiliser nos API dans vos programmes.

  1. Dans Control Center, aller dans Intégrations > Intégrations dans le Cloud.

  2. Trouver l'intégrateur connecté à votre souscription au Portail développeur, puis cliquer sur Copier la clé. Envoyez cette clé à votre développeur tiers.

Instructions pour votre développeur tiers :

  1. Se connecter au Portail développeur de Loftware.

  2. Aller dans Produits > Loftware Cloud.

  3. Cliquer sur Connexion Développeur API v1.

  4. Cliquer sur Essayer.

  5. Saisir ou coller votre clé à partir de Control Center dans la case IntegratorKey.

  6. Sous Autorisation, sélectionner votre clé de souscription principale ou secondaire (utiliser la principale par défaut). Pour plusieurs clients, assurez-vous de sélectionner votre souscription appropriée.

  7. Cliquer sur Envoyer.

Quand votre développeur clique sur Envoyer, retourner à Control Center > Intégrations > Intégrations dans le Cloud et actualiser votre onglet de navigateur. Control Center confirme la souscription de votre développeur.

Votre développeur tiers est connecté et prêt à utiliser nos API.

[Note] Note

Vos clés de souscription fonctionnent pour plusieurs développeurs. À des fins de transparence et de sécurité, nous vous conseillons de créer des intégrations au Cloud distinctes pour chaque développeur. Avec cette méthode, vous pouvez révoquer l’accès de développeurs individuels en supprimant leurs intégrations au Cloud respectives, sans affecter l’accès de vos autres développeurs.

Pour des informations complémentaires sur le déploiement de déclencheurs de Cloud, consultez le Guide d’utilisateur Automation : déclencheurs de Cloud.

Pour plus d’informations sur Cloud Print, consultez Comprendre Cloud Print.

Pour plus d’informations sur l’API Cloud Print, consultez Comprendre l’API Cloud Print.