Gestion des entreprises et des développeurs utilisant Edge

Vous consultez la documentation Apigee Edge.
Accédez à la documentation**Apigee X**. info

Si vous souhaitez mieux contrôler les entreprises et les développeurs qui participent à votre programme d'API monétisé (par exemple, si vous souhaitez créer des entreprises et des développeurs internes à des fins de test) vous pouvez les créer manuellement à l'aide de l'interface utilisateur de gestion et de l'API.

Pour déterminer si vous devez créer manuellement des entreprises et des développeurs, vous devez avant tout vous demander si les développeurs auront besoin d'identifiants pour se connecter à l'interface utilisateur de gestion, envoyer des identifiants dans les appels à l'API de gestion Edge ou se connecter à un portail des développeurs.

• Si vos développeurs de monétisation ont besoin d'identifiants de connexion pour accéder à l'interface utilisateur ou à l'API Edge, ils doivent d'abord disposer de leur propre compte d'administrateur Apigee.
• Si vous avez simplement besoin de créer des développeurs de test qui n'ont pas besoin d'identifiants (par exemple, si vous souhaitez effectuer des appels d'API avec des développeurs de test fictifs), aucun compte Apigee n'est requis.

Gérer les développeurs d'applications à l'aide de l'interface utilisateur

Créez, gérez et activez des développeurs d'applications à l'aide de l'interface utilisateur Edge, comme décrit dans la section Gérer les développeurs d'applications. Une fois les développeurs d'applications créés, vous pouvez les ajouter à des entreprises, comme décrit dans les sections suivantes.

Gérer les entreprises à l'aide de l'interface utilisateur

Créez, gérez et activez des entreprises, comme décrit dans les sections suivantes.

Explorer la page "Entreprises"

Accédez à la page "Entreprises", comme décrit ci-dessous.

Ajouter une entreprise

Pour ajouter une entreprise :

1. Accédez à la page "Entreprises".
2. Cliquez sur + Entreprise.
3. Saisissez les informations sur l'entreprise.

   Voici certains des champs obligatoires :

   • Nom de l'entreprise
   • Administrateur (utilisateur qui est l'administrateur principal de l'entreprise )
   • Type de facturation

   En fonction de la configuration de facturation de la monétisation, le type de facturation peut être défini par défaut sur PREPAID ou POSTPAID. Pour en savoir plus, consultez la section Configurer les types de facturation prépayée et postpayée à l'aide de l'API.

4. Ajoutez un ou plusieurs développeurs à l'entreprise.
   1. Dans la section "Développeurs", saisissez une chaîne dans le champ Ajouter un développeur pour afficher la liste des développeurs qui correspondent à la chaîne.
   2. Sélectionnez un développeur dans la liste déroulante.
   3. Répétez l'opération pour ajouter d'autres développeurs à l'entreprise.
5. Ajoutez un ou plusieurs attributs personnalisés.
   1. Dans la section "Attributs personnalisés", cliquez sur + Nouveau.
   2. Saisissez le nom et la valeur de l'attribut personnalisé.
   3. Répétez l'opération pour ajouter d'autres attributs personnalisés à l'entreprise.
6. Cliquez sur Créer une entreprise.

Activer et désactiver une entreprise

Pour activer et désactiver une entreprise :

1. Accédez à la page "Entreprise".
2. Placez le curseur sur l'entreprise que vous souhaitez activer et activez dans le menu "Actions".
   Désactivez le bouton pour désactiver l'entreprise.

Modifier une entreprise

Pour modifier une entreprise :

1. Accédez à la page "Entreprise".
2. Placez le curseur sur l'entreprise que vous souhaitez modifier, puis cliquez sur dans le menu "Actions".
3. Modifiez les informations sur l'entreprise, si nécessaire.
4. Cliquez sur Mettre à jour l'entreprise pour enregistrer les modifications.

Supprimer une entreprise

Pour supprimer une entreprise :

1. Accédez à la page "Entreprises".
2. Placez le curseur sur l'entreprise que vous souhaitez supprimer, puis cliquez sur dans le menu "Actions".
3. Cliquez sur Supprimer pour confirmer la suppression.

Gérer les entreprises et les développeurs à l'aide de l'API

L'utilisation de l'API pour gérer les entreprises et les développeurs est décrite dans les sections suivantes.

Créer et mettre à jour des entreprises et des développeurs à l'aide de l'API

Pour gérer les entreprises et les développeurs avec l'API de gestion Edge, consultez les sections suivantes de l'API :

• Créer une entreprise
• Créer un développeur
  Remarque : Configurez les informations de monétisation lors de la création d'un développeur en transmettant des attributs personnalisés.
• Ajouter ou mettre à jour des développeurs d'entreprise
  Remarque : Vous pouvez éventuellement attribuer un rôle au développeur, mais ce n'est pas obligatoire. Pour obtenir la liste des rôles de développeur, consultez la section Récupérer les rôles de développeur.
• Répertorier la configuration de monétisation pour tous les développeurs ou pour un seul développeur
  Remarque : Définissez les informations de monétisation en transmettant des attributs personnalisés lors de la création ou de la mise à jour d'un développeur. Vous pouvez afficher les attributs personnalisés de monétisation définis à l'aide de l'API standard (non monétisation) pour répertorier tous les développeurs ou un seul développeur.

Gérer les rôles de développeur à l'aide de l'API

Vous pouvez créer des rôles à l'aide des API de monétisation. Cela vous permet d'établir des rôles pour vos partenaires. Par exemple, vous pouvez établir des rôles d'administrateur et de développeur d'applications pour un partenaire. Ces rôles peuvent ensuite être attribués à des employés partenaires spécifiques.

Créer un rôle de développeur

Pour créer un rôle de développeur, envoyez une requête POST à organizations/{org_name}/developer-roles. Lorsque vous effectuez la requête, vous devez spécifier dans le corps de la requête le nom et la description du rôle, ainsi que l'identification de l' organisation. Exemple :

$ curl -H "Content-Type:application/json" -X POST -d \
'{
   "name": "appDeveloper",
   "description": "App Developer",
   "organization": {
       "id": "{org_name}"
   }
 }' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developer-roles" \
-u email:password

Récupérer les rôles de développeur

Pour récupérer les rôles de développeur, envoyez une requête GET à organizations/{org_id}/developer-roles. Exemple :

$ curl -H "Accept:application/json" -X GET \
"https:// api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developer-roles" \
-u email:password

La réponse doit se présenter comme suit (seule une partie de la réponse est affichée) :

{
  "description" : "App Developer",
  "id" : "appdeveloper",
  "name" : "appDeveloper",
  "organization" : {
   ...
  }
}

Paramètres de configuration des rôles de développeur pour l'API

Les options de configuration des rôles de développeur suivantes sont exposées à l'API :

Récupérer le taux d'imposition d'un développeur à l'aide de l'API

Vous pouvez obtenir le taux d'imposition actuel d'un développeur en envoyant une requête GET à organizations/{org_name}/tax-engine. Lorsque vous effectuez la requête, vous devez spécifier l'identification du développeur en tant que paramètre de requête. Exemple :

$ curl -H "Accept:application/json" -X GET \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/tax-engine?developerId=dev7@myorg.com" \
-u email:password

La réponse doit se présenter comme suit :

0.09

Effectuer d'autres tâches spécifiques aux développeurs à l'aide de l'API

Vous pouvez également effectuer pour un développeur individuel de nombreuses tâches liées à la monétisation que vous pouvez effectuer pour une organisation, telles que la création de plans tarifaires ou de conditions de notification. Par exemple, vous pouvez créer un compte bancaire pour un développeur spécifique ou générer un rapport sur les revenus pour un développeur spécifique.

Le tableau suivant répertorie les tâches spécifiques aux développeurs que vous pouvez effectuer à l'aide des API de monétisation. Il indique également où trouver des instructions détaillées sur l'exécution de ces tâches.