Konfigurowanie powiadomień na podstawie sum łącznych transakcji dla firmy i jej deweloperów

Wyświetlasz dokumentację Apigee Edge.
Przejdź do dokumentacji Apigee X.
info

Zwykle sumy transakcji są automatycznie śledzone w przypadku wszystkich deweloperów w firmie, gdy deweloperzy używają aplikacji firmowej do uzyskiwania dostępu do interfejsów API.

Co zrobić, jeśli masz deweloperów, którzy aktywnie korzystają z własnych aplikacji deweloperskich, aby uzyskiwać dostęp do interfejsów API, a musisz śledzić ich łączne sumy transakcji bez zakłócania ruchu? Możesz dodać deweloperów do firmy i skonfigurować wysyłanie powiadomień na podstawie łącznych sum transakcji firmy i jej deweloperów. Musisz włączyć tę funkcję w każdej firmie. Domyślnie jest ona wyłączona. Po włączeniu łączne sumy transakcji są obliczane co godzinę.

Jeśli powiadomienia są skonfigurowane, są wysyłane po osiągnięciu progów łącznej sumy transakcji. Osobne powiadomienie jest wyzwalane w przypadku każdego dewelopera w firmie który zaakceptował plan z regulowaną stawką powiadomień.

Aby uwzględnić łączne sumy transakcji w raportach, musisz ręcznie dodać firmę i wszystkich odpowiednich deweloperów do kryteriów raportu. Więcej informacji znajdziesz w artykule Tworzenie raportów.

Aby połączyć sumy transakcji w ramach planu lub firmy i jej deweloperów:

  1. Utwórz plan z regulowaną stawką powiadomień zgodnie z opisem w artykule Określanie szczegółów planu z regulowaną stawką powiadomień.
  2. Skonfiguruj powiadomienia za pomocą webhooków zgodnie z opisem w artykule Konfigurowanie powiadomień za pomocą webhooków.
  3. Użyj interfejsu Get Company Details API, aby uzyskać wszystkie atrybuty obecnie ustawione w firmie. Będą one potrzebne w następnym kroku.
  4. Aby włączyć tę funkcję, dodaj atrybut niestandardowy MINT_NOTIFICATION_COMBINE_COMPANY_DEVELOPERS z wartością true do firmy za pomocą interfejsu Update Company API. Pamiętaj, aby w wywołaniu interfejsu API uwzględnić też inne dotychczasowe atrybuty firmy.

    Aby na przykład włączyć tę funkcję w przypadku firmy 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. Firma i jej deweloperzy akceptują plan z regulowaną stawką powiadomień.

    Uwaga: aby uniknąć nieporozumień, zalecamy, aby firma i deweloperzy ustawili tę samą datę rozpoczęcia, tak aby dane transakcji były śledzone w spójnym przedziale czasu.

    Uwaga:

    • Jeśli firma nie zaakceptuje planu, nie nastąpi połączenie sum transakcji w ramach planu dla firmy i jej deweloperów.
    • Jeśli deweloper nie zaakceptuje planu, wywołania wykonywane przez tego dewelopera do produktów objętych zarabianiem zostaną zablokowane.