Gestion des entreprises et des développeurs utilisant Edge

Vous consultez la documentation d'Apigee Edge.
Accédez à la documentation sur Apigee X. info

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

Le principal facteur qui détermine si vous devez créer des entreprises et des développeurs manuellement est de savoir si les développeurs auront besoin d'identifiants pour se connecter à l'UI de gestion, envoyer des identifiants dans les appels à l'API de gestion Edge ou se connecter à un portail de développeur.

• Si vos développeurs de monétisation ont besoin d'identifiants de connexion pour accéder à l'UI ou à l'API Edge, ils doivent d'abord disposer de leur propre compte administrateur Apigee.
• Si vous devez simplement 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'UI

Créez, gérez et activez des développeurs d'applications à l'aide de l'UI 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 des entreprises à l'aide de l'UI

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 votre entreprise.

   Les champs obligatoires incluent :

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

   Selon la configuration de la 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 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 correspondant à 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, puis activez dans le menu d'actions.
   Désactivez le bouton bascule 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 d'actions.
3. Si nécessaire, mettez à jour les informations sur l'entreprise.
4. Cliquez sur Modifier 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 d'actions.
3. Cliquez sur Supprimer pour confirmer la suppression.

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

Les sections suivantes décrivent comment utiliser l'API pour gérer les entreprises et les développeurs.

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 à l'aide de l'API de gestion d'Apigee Edge, consultez les sections d'API suivantes:

• Créer une entreprise
• Créer un développeur
  Remarque: Lorsque vous créez un développeur, configurez les informations de monétisation en transmettant des attributs personnalisés.
• Ajouter ou modifier des développeurs de l'entreprise
  Remarque: Vous pouvez 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.
• Listez la configuration de la monétisation pour tous les développeurs ou pour un développeur spécifique.
  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 liée à la monétisation) pour lister tous les développeurs ou un développeur spécifique.

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. Vous pouvez ainsi définir des rôles pour vos partenaires. Par exemple, vous pouvez définir 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 du rôle de développeur pour l'API

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

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

Vous pouvez obtenir le taux de taxe 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 effectuer de nombreuses tâches liées à la monétisation pour une organisation, comme créer des tarifs ou des conditions de notification, mais aussi pour un développeur individuel. 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. Le tableau indique également où trouver des instructions détaillées pour effectuer ces tâches.