Vous consultez la documentation d'Apigee Edge.
Consultez la
documentation Apigee X. en savoir plus
Introduction
Vous devez ajouter des conditions d'utilisation ("Conditions d'utilisation") au profil de votre organisation avant de publier un plan tarifaire. Les conditions d'utilisation résident en dehors du profil de l'organisation. Dans le profil de votre organisation, vous spécifiez l'emplacement (URL publique) des conditions d'utilisation.
Une fois le plan tarifaire publié, la version actuelle des conditions d'utilisation est affichée sur le portail des développeurs. Les développeurs ne peuvent souscrire un forfait qu'après avoir accepté les conditions d'utilisation actuelles.
Ajouter des conditions d'utilisation à l'aide de l'interface utilisateur
- Accédez à la page "Profil de l'organisation", comme indiqué dans Explorer la page "Profil de l'organisation".
- Cliquez sur Modifier.
- Dans la section "Conditions d'utilisation" de la page "Profil de l'organisation", cliquez sur Ajouter des conditions d'utilisation.
La boîte de dialogue "Nouvelles conditions d'utilisation" s'affiche.
- Saisissez les informations suivantes :
Champ Description Date d'entrée en vigueur Date d'entrée en vigueur des conditions d'utilisation. La valeur par défaut est la date actuelle. Vous devez saisir la date actuelle ou une date ultérieure.
Version Version des conditions d'utilisation. Le numéro de version vous permet d'effectuer le suivi des différentes versions des conditions d'utilisation.
URL URL des conditions d'utilisation.
- Cliquez sur Créer.
Les nouvelles conditions d'utilisation sont ajoutées à la section "Conditions d'utilisation" de la page "Profil de l'organisation".
- Répétez les étapes 3 à 5 pour ajouter des conditions d'utilisation supplémentaires.
- Cliquez sur Enregistrer pour enregistrer les modifications apportées au profil de l'organisation.
Modification des conditions d'utilisation à l'aide de l'interface utilisateur
Vous ne pouvez pas modifier directement les conditions d'utilisation. À la place, vous devez supprimer les conditions d'utilisation que vous souhaitez modifier, puis ajouter une nouvelle entrée.
Supprimer des conditions d'utilisation à l'aide de l'interface utilisateur
- Accédez à la page "Profil de l'organisation", comme indiqué dans Explorer la page "Profil de l'organisation".
- Cliquez sur Modifier sur la page "Profil de l'organisation".
- Dans la liste des conditions d'utilisation, placez le curseur sur celles que vous souhaitez supprimer.
- Cliquez sur .
Gérer les conditions d'utilisation à l'aide de l'API
Gérez les conditions d'utilisation à l'aide de l'API, comme décrit dans les sections suivantes.
Ajouter des conditions d'utilisation à l'aide d'une API
Ajoutez les conditions d'utilisation en envoyant une requête POST à /mint/organizations/{org_name}/tncs
.
Lorsque vous ajoutez les conditions d'utilisation, vous pouvez éventuellement spécifier:
- URL
- Le texte associé (une description, par exemple)
- Date d'entrée en vigueur des conditions d'utilisation
- Numéro de version
Pour en savoir plus sur ces options, consultez la section Propriétés de configuration des conditions d'utilisation.
Exemple :
curl -X POST "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/tncs" \ -H "Content-Type: application/json" \ -d \ '{ "url":"www.testoperator/termsandconditions", "tncText":"Sample text for the T&C", "version":"1.1", "startDate":"2018-09-24" }' \ -u email:password
Voici un exemple de réponse :
{ "id" : "6803d70a-18cc-40c8-b250-675c5e8a75c ", "organization" : { … }, "startDate" : "2018-09-24 00:00:00", "tncText" : "Sample text for the T&C", "url" : "www.testoperator/termsandconditions", "version" : "1.1" }
Afficher les conditions d'utilisation à l'aide de l'API
Afficher des conditions d'utilisation spécifiques ou toutes les conditions d'utilisation d'une organisation.
Affichez des conditions d'utilisation spécifiques en envoyant une requête GET à /mint/organizations/{org_name}/tncs/{tncs_id}
, où {tncs_id}
correspond à l'identification des conditions d'utilisation spécifiques (l'ID est renvoyé dans la réponse lorsque vous les créez). Exemple :
curl -X GET "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/tncs/6803d70a-18cc-40c8-b250-675c5e8a75c" \ -H "Accept: application/json" \ -u email:password
Affichez toutes les conditions d'utilisation de l'organisation en envoyant une requête GET à /mint/organizations/{org_name}/tncs
. Exemple :
curl -X GET "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/tncs" \ -H "Accept: application/json" \ -u email:password
Voici un exemple de réponse :
{
"tnc" : [ { "id" : "77193339-8d79-44a8-8af2-3593f16c158e", "organization" : { ... }, "startDate" : "2018-07-01 00:00:00", "tncText" : "Big operator text for the T&C", "url" : "www.bigoperator/termsandconditions", "version" : "1.0" }, { "id" : "6803d70a-18cc-40c8-b250-675c5e8a75c3", "organization" : { ... }, "startDate" : "2018-09-24 00:00:00", "tncText" : "Sample text for the T&C", "url" : "www.testoperator/termsandconditions", "version" : "1.1" } ] "totalRecords" : 2 }
Accepter les conditions d'utilisation d'un développeur ou d'une entreprise qui utilisent l'API
Acceptez un document des conditions d'utilisation pour un développeur ou une entreprise spécifique en envoyant une requête POST à l'une des API suivantes, respectivement:
/mint/organizations/{org_name}/developers/{dev_id}/tncs/{tncs_id}/developer-tncs
/mint/organizations/{org_name}/companies/{company_id}/tncs/{tncs_id}/developer-tncs
Où {dev_id}
est l'ID de développeur (adresse e-mail), {company_id}
est l'ID de l'entreprise, et {tncs_id}
est l'ID du document des conditions d'utilisation.
Exemple :
curl -X POST "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers/dev2@myorg.com/tncs/5a291b86-42e3-4ae1-8db3-efe4b0877316/developer-tncs" \ -H "Content-Type: application/json" \ -d \ '{ "action":"ACCEPTED", "auditDate":"2018-10-01 00:00:00" }' \ -u email:password
Voici un exemple de réponse :
auditDate
est défini sur l'heure actuelle au format UTC.{ "action": "ACCEPTED", "auditDate": "2018-10-01 07:24:45", "id": "dev2@myorg.com", "tnc": { "id": "5a291b86-42e3-4ae1-8db3-efe4b0877316", ... } }
Afficher les conditions d'utilisation acceptées par un développeur ou une entreprise à l'aide de l'API
Affichez les conditions d'utilisation acceptées par un développeur ou une entreprise spécifique en envoyant une requête GET à l'une des API suivantes, respectivement:
/mint/organizations/{org_name}/developers/{dev_id}/developer-tncs
/mint/organizations/{org_name}/companies/{company_id}/developer-tncs
Où {dev_id}
correspond à l'ID de développeur (adresse e-mail) et {company_id}
à l'ID de l'entreprise.
Exemple :
curl -X GET "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers/dev2@myorg.com/developer-tncs" \ -H "Accept:application/json" \ -u email:password
Voici un exemple de réponse :
{ "developerTnc": [ { "action": "ACCEPTED", "auditDate": "2018-08-29 07:24:45", "id": "dev2@myorg.com", "tnc": { "id": "26abc14c-c628-4c38-8840-a343c8ee9437", ... } }], "totalRecords": 1 }
Modification des conditions d'utilisation à l'aide de l'API
Modifiez les conditions d'utilisation en envoyant une requête PUT à /mint/organizations/{org_named}/tncs/{tncs_id}
, où {tncs_id}
correspond à l'identification des conditions d'utilisation. Lorsque vous effectuez la mise à jour, vous devez spécifier dans le corps de la requête les paramètres mis à jour et l'identification des conditions d'utilisation. Par exemple, la requête suivante modifie le numéro de version des conditions d'utilisation (la propriété mise à jour est mise en surbrillance dans l'exemple):
curl -X PUT "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/tncs/cfbb03b3-b707-495b-9b8a-ff67d71065a9" \ -H "Content-Type: application/json" \ -d { "id":"6803d70a-18cc-40c8-b250-675c5e8a75c", "version":"1.2" }' \ -u email:password
Voici un exemple de réponse :
{ "id" : "cfbb03b3-b707-495b-9b8a-ff67d71065a9", "organization" : { "address" : [ { "address1" : "Test address", "city" : "Test City", "country" : "US", "id" : "test-address", "isPrimary" : true, "state" : "CA", "zip" : "54321" } ], …" }, "startDate" : "2018-09-24 00:00:00", "tncText" : "Sample text for the T&C", "url" : "www.testoperator/termsandconditions", "version" : "1.2" }
Supprimer des conditions d'utilisation à l'aide de l'API
Supprimez les conditions d'utilisation en envoyant une requête DELETE à /mint/organizations/{org_name}/tncs/{tncs_id}
, où {tncs_id}
est l'identification des conditions d'utilisation. Exemple :
curl -X DELETE "https://api.enterprise.apigee.com/v1/mint/organizations/myorg/tncs/6803d70a-18cc-40c8-b250-675c5e8a75c" \ -H "Accept: application/json" \ -u email:password
Propriétés de configuration des conditions d'utilisation pour l'API
Le tableau suivant récapitule les propriétés de configuration qui peuvent être définies à l'aide de l'API pour les conditions d'utilisation.
Nom | Description | Par défaut | Obligatoire ? |
---|---|---|---|
url |
URL des conditions d'utilisation. |
N/A | Non |
tncText |
Un texte (une brève description, par exemple) des conditions d'utilisation |
N/A | Non |
version |
Version des conditions d'utilisation. Le numéro de version vous permet d'effectuer le suivi des différentes versions des conditions d'utilisation. |
N/A | Oui |
startDate |
Date d'entrée en vigueur des conditions d'utilisation. |
N/A | Oui |
organization |
Organisation des conditions d'utilisation. |
N/A | Non |
Étapes suivantes
Découvrez comment ajouter des devises acceptées à celles configurées initialement pour votre organisation dans Gérer les devises acceptées.