Gérer les catégories de développeurs

<ph type="x-smartling-placeholder"></ph> Vous consultez la documentation Apigee Edge.
Accédez à la page Documentation sur Apigee X. En savoir plus

Une catégorie de développeur est un groupe de développeurs ou d'entreprises ayant des caractéristiques similaires qui permet de configurer la monétisation pour cette catégorie spécifique. Par exemple : peuvent créer des plans tarifaires qui s'appliquent à tous les développeurs qui développent des applications pour le partage des revenus la création d'une catégorie de développeur appelée "revenue_sharing" et y ajouter des développeurs. Pour plus pour en savoir plus sur la création de plans tarifaires avec des catégories de développeurs, consultez l'article Créer des plans tarifaires.

Explorer la page "Catégories de développeurs"

Accédez à la page "Catégories de développeurs" à l'aide de l'interface utilisateur Edge ou classique, comme décrit dans les sections suivantes.

Ajouter une catégorie de développeur

Pour ajouter une catégorie de développeur à l'aide de l'interface utilisateur:

1. Accédez à la page Développer des catégories.
2. Cliquez sur + Catégorie de développeur.
3. Saisissez un nom pour la nouvelle catégorie et une brève description.
4. Cliquez sur Créer une catégorie de développeur.

Ajouter une entreprise à la catégorie "Développeur"

Ajoutez une entreprise à la catégorie "Développeur". Une entreprise ne peut appartenir qu'à une seule catégorie de développeur.

Pour ajouter une entreprise à une catégorie de développeur:

1. Sélectionnez Publier > Sociétés dans la barre de navigation supérieure.
2. Sélectionnez l'entreprise que vous souhaitez ajouter à la catégorie de développeur.
3. Cliquez sur Modifier sur la page de la société.
4. Sélectionnez la catégorie de développeur pour l'entreprise.
5. Cliquez sur Enregistrer.
   

Modifier une catégorie de développeur

Pour modifier une catégorie de développeur à l'aide de l'interface utilisateur:

1. Accédez à la page Développer des catégories.
2. Placez le curseur sur la catégorie de développeur que vous souhaitez modifier, puis cliquez sur .
3. Saisissez la catégorie de développeur.
4. Cliquez sur Mettre à jour la catégorie de développeur.

Supprimer une catégorie de développeur

Pour supprimer une catégorie de développeur à l'aide de l'interface utilisateur:

1. Accédez à la page Développer des catégories.
2. Placez le curseur sur la catégorie de développeur que vous souhaitez modifier.
3. Cliquez sur .
4. Cliquez sur Supprimer pour confirmer l'opération.

Gérer les catégories de développeurs à l'aide de l'API

Gérez les catégories de développeurs à l'aide de l'API, comme décrit dans les sections suivantes.

Ajouter une catégorie de développeur à l'aide de l'API

Ajoutez une catégorie de développeur en envoyant une demande POST à /mint/organizations/{org_name}/developer-categories

Lorsque vous émettez la requête, vous spécifiez la catégorie name et description dans la charge utile. Exemple :

curl -X POST "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developer-categories" \
  -H "Content-Type:application/json"  \
  -d '{
    "name": "Gold",
    "description": "Gold membership"
  }' \
  -u email:password

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

{
  "description" : "Gold membership",
  "id" : "aa6f960a-d9fd-416e-be39-c071418aabd0",
  "name" : "Gold"
}

Ajouter un développeur ou une entreprise à une catégorie de développeur à l'aide de l'API

Ajoutez un développeur ou une entreprise à une catégorie de développeur lorsque vous ajoutez ou modifiez l'entreprise ou développeur en émettant POST aux ressources suivantes, respectivement:

• /organizations/{org_name}/companies
• /organizations/{org_name}/developers

Pour ajouter un développeur ou une entreprise à une catégorie lorsque vous la modifiez, envoyez un PUT aux ressources suivantes, respectivement:

• /organizations/{org_name}/companies/{company_id}
• /organizations/{org_name}/developers/{developer_id}

Une entreprise ou un développeur ne peut appartenir qu'à une seule catégorie de développeur.

Spécifiez MINT_DEVELOPER_CATEGORY en tant qu'attribut dans le corps de la requête à l'aide de la propriété comme valeur. Par exemple, la requête suivante ajoute un champ dans la catégorie "Or" catégorie, dont l'identifiant est aa6f960a-d9fd-416e-be39-c071418aabd0

curl -X PUT "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers/K4jW2QLjZ1h8GFA8" \
  -H "Content-Type: application/json" \
  -d '{
   "email" : "developer@apigee.com",
    "developerId" : "K4jW2QLjZ1h8GFA8",
    "firstName" : "Dev",
    "lastName" : "One",
    "userName" : "devone",    
    "attributes" : [ {
      "name" : "MINT_REGISTRATION_ID",
      "value" : "dev1"
    }, {
      "name" : "MINT_DEVELOPER_LEGAL_NAME",
      "value" : "DEV ONE"
    }, {
      "name" : "MINT_DEVELOPER_TYPE",
      "value" : "TRUSTED"
    }, {
      "name" : "MINT_BILLING_TYPE",
      "value" : "PREPAID"
    }, {
      "name" : "MINT_IS_BROKER",
      "value" : "TRUE"
    }, {
      "name" : "MINT_DEVELOPER_CATEGORY",
      "value" : "aa6f960a-d9fd-416e-be39-c071418aabd0"
    }, {
      "name" : "MINT_DEVELOPER_ADDRESS",
      "value" : "{
                   "address1": "Dev One Address",
                   "city": "Pleasanton",
                   "country": "US",
                   "isPrimary": "true",
                   "state": "CA",
                   "zip": "94588"
                }"
    }
  }' \
  -u email:password

Afficher les catégories de développeurs à l'aide de l'API

Afficher une catégorie de développeurs spécifique ou toutes les catégories de développeurs d'une organisation.

Affichez une catégorie de développeurs spécifique en envoyant une demande GET à /mint/organizations/{org_name}/developer-categories/{category_id}, où {category_id} est l'identification de la catégorie de développeur (l'ID est renvoyé dans la réponse lorsque vous ajoutez la catégorie de développeur). Exemple :

curl -X GET "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developer-categories/aa6f960a-d9fd-416e-be39-c071418aabd0" \
  -H "Accept:application/json" \
  -u email:password

Affichez toutes les catégories de développeurs d'API pour une organisation en envoyant une demande GET à /mint/organizations/{org_id}/developer-categories Exemple :

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

Modifier une catégorie de développeur à l'aide de l'API

Pour modifier une catégorie de développeur, envoyez une requête PUT à /mint/organizations/{org_name}/developer-categories/{category_id}, où {category_id} est l'identification de la catégorie à mettre à jour. Vous devez spécifier dans le corps de la requête les paramètres mis à jour et l'identifiant du développeur. catégorie. Par exemple, la demande suivante modifie la description d'une catégorie de développeur:

curl -X PUT "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developer-categories/aa6f960a-d9fd-416e-be39-c071418aabd0" \
  -H "Content-Type: application/json"  \
  -d '{
    "id": "aa6f960a-d9fd-416e-be39-c071418aabd0",
    "description": "Premium membership"
  }' \
  -u email:password

Supprimer une catégorie de développeur à l'aide de l'API

Supprimer une catégorie de développeur en envoyant une demande DELETE à /mint/organizations/{org_name}/developer-categories/{category_id}, où {category_id} est l'identification de la catégorie de développeur à supprimer. Exemple :

curl -X DELETE "https://api.enterprise.apigee.com /v1/mint/organizations/{org_name}/developer-categories/aa6f960a-d9fd-416e-be39-c071418aabd0" \
  -H "Accept:application/json" \
  -u email:password

Propriétés de configuration de la catégorie de développeur pour l'API

Le tableau suivant récapitule les propriétés de configuration pouvant être définies à l'aide de l'API.