Configurer des notifications basées sur le total des transactions pour une entreprise et ses développeurs

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

En règle générale, les totaux des transactions sont suivis automatiquement pour tous les développeurs d'une entreprise lorsque ceux-ci utilisent l'application de l'entreprise pour accéder aux API.

Que faire si des développeurs utilisent activement leurs propres applications de développement pour accéder aux API, et que vous devez suivre leurs totaux de transactions combinés sans aucune interruption du trafic ? Vous pouvez ajouter les développeurs à une entreprise et configurer l'envoi de notifications basées sur les totaux de transactions combinés pour l'entreprise et ses développeurs. Vous devez activer cette fonctionnalité par entreprise. Elle est désactivée par défaut. Une fois activée, les totaux de transactions combinés sont calculés toutes les heures.

Si des notifications sont configurées, elles sont envoyées lorsque les totaux de transactionscombinés sont atteints. Une notification distincte est déclenchée pour chaque développeur de l'entreprise qui a accepté le plan tarifaire à taux de notification ajustable.

Pour inclure les totaux de transactions combinés dans les rapports, vous devez inclure manuellement l'entreprise et tous les développeurs concernés dans les critères du rapport. Pour en savoir plus, consultez Créer des rapports.

Pour combiner les totaux de transactions d'un plan tarifaire ou d'une entreprise et de ses développeurs :

  1. Créez un plan tarifaire à taux de notification ajustable, comme décrit dans Spécifier les détails d'un plan de notification ajustable.
  2. Configurez des notifications à l'aide de webhooks, comme décrit dans Configurer des notifications à l'aide de webhooks.
  3. Utilisez l'API Get Company Details pour obtenir tous les attributs existants actuellement définis pour l'entreprise. Vous en aurez besoin à l'étape suivante.
  4. Pour activer cette fonctionnalité, ajoutez l'MINT_NOTIFICATION_COMBINE_COMPANY_DEVELOPERS attribut personnalisé à true l'entreprise à l'aide de l'API Update Company. Veillez également à inclure vos autres attributs d'entreprise existants dans l'appel d'API.

    Par exemple, pour activer cette fonctionnalité pour xyz-company :

    $ curl -H "Content-Type:application/json" -X PUT -d \
    '{
        "name": "xyz-company",
        "attributes": [
            {
                "name": "MINT_NOTIFICATION_COMBINE_COMPANY_DEVELOPERS",
                "value": "true"
            }
          ... also include other existing company attributes to avoid losing them
       ]
    }'\
    "https://api.enterprise.apigee.com/v1/organizations/myorg/companies/xyz-company"  \
    -u email:password
  5. L'entreprise et ses développeurs acceptent le plan tarifaire à taux de notification ajustable.

    Remarque : Pour éviter toute confusion, il est recommandé que l'entreprise et les développeurs définissent la même date de début afin que les données de transaction soient suivies sur un intervalle de temps cohérent.

    Remarque :

    • Si l'entreprise n'accepte pas le plan tarifaire, la combinaison des totaux de transactions du plan tarifaire pour l'entreprise et ses développeurs ne se produira pas.
    • Si un développeur n'accepte pas le plan tarifaire, les appels qu'il effectue vers les produits monétisés seront bloqués.