Gérer les catégories de développeurs

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

Une catégorie de développeur est un groupe de développeurs ou d'entreprises présentant des caractéristiques similaires qui vous permet de configurer la monétisation pour qu'elle s'applique à cette catégorie spécifique. Par exemple, vous pouvez créer des forfaits qui s'appliquent à tous les développeurs qui développent des applications pour le partage des revenus en créant une catégorie de développeurs appelée "revenue_sharing" et en y ajoutant des développeurs. Pour en savoir plus sur la création de plans tarifaires avec des catégories de développeurs, consultez 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éveloppeurs

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 et une brève description pour la nouvelle catégorie.
4. Cliquez sur Créer une catégorie de développeur.

Ajouter une entreprise à une catégorie de développeurs

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

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

1. Sélectionnez Publier > Entreprises dans la barre de navigation supérieure.
2. Sélectionnez l'entreprise que vous souhaitez ajouter à la catégorie "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éveloppeurs

Pour modifier une catégorie de développeurs à 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éveloppeurs que vous souhaitez modifier, puis cliquez sur .
3. Saisissez la catégorie du développeur.
4. Cliquez sur Modifier la catégorie de développeur.

Supprimer une catégorie de développeur

Pour supprimer une catégorie de développeurs à 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éveloppeurs 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éveloppeurs en envoyant une requête POST à /mint/organizations/{org_name}/developer-categories.

Lorsque vous envoyez la requête, vous spécifiez les catégories 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éveloppeurs à l'aide de l'API

Ajoutez un développeur ou une entreprise à une catégorie de développeurs lorsque vous ajoutez ou modifiez l'entreprise ou le développeur en envoyant une requête POST aux ressources suivantes, respectivement:

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

Pour ajouter un développeur ou une entreprise à une catégorie de développeurs lorsque vous modifiez l'entreprise ou le développeur, envoyez une requête 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éveloppeurs.

Spécifiez MINT_DEVELOPER_CATEGORY en tant qu'attribut dans le corps de la requête avec l'ID interne de la catégorie comme valeur. Par exemple, la requête suivante ajoute un développeur déjà existant à la catégorie de développeurs nommée "Or", dont l'ID 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 requête GET à /mint/organizations/{org_name}/developer-categories/{category_id}, où {category_id} est l'identification de la catégorie de développeurs (l'ID est renvoyé dans la réponse lorsque vous ajoutez la catégorie de développeurs). 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 d'une organisation en envoyant une requête 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

Modifiez une catégorie de développeurs en envoyant une requête PUT à /mint/organizations/{org_name}/developer-categories/{category_id}, où {category_id} correspond à 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'ID de la catégorie de développeur. Par exemple, la requête suivante modifie la description d'une catégorie de développeurs:

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

Supprimez une catégorie de développeurs en envoyant une requête DELETE à /mint/organizations/{org_name}/developer-categories/{category_id}, où {category_id} correspond à l'identification de la catégorie de développeurs à 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.

Nom	Description	Par défaut	Obligatoire ?
name	Nom de propriété Défini sur MINT_DEVELOPER_CATEGORY.	N/A	Oui
value	ID de la catégorie de développeur à laquelle le développeur est ajouté.	N/A	Oui, pour définir la catégorie de développeur.