Przenoszenie deweloperów do generowania przychodu

Wyświetlasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X.
informacje.

Jeśli masz obecnych deweloperów i chcesz przejść na funkcję Zarabianie:

  1. Utwórz usługi API, pakiety API i plany stawek dla deweloperów, których konta chcesz przenieść, jeśli jeszcze ich nie istnieją. Więcej informacji:
  2. Opublikuj plany stawek zgodnie z opisem w sekcji Publikowanie planów stawek.
  3. Dodaj nowych deweloperów do swojej organizacji zgodnie z opisem w artykule Rejestrowanie deweloperów aplikacji.
  4. Doładuj saldo z góry dla każdego dewelopera zgodnie z opisem w artykule Zarządzanie saldem kont przedpłaconych.
  5. Zaakceptuj abonament zgodnie z opisem w sekcji Abonamenty stawek za zakupy przy użyciu interfejsu API.

    Uwaga: aby zrezygnować z opłat konfiguracyjnych, jeśli deweloper został już obciążony, ustaw parametr zapytania waivefees na true.

  6. Jeśli deweloper, którego przenosisz, ma już transakcje, możesz ręcznie przenieść ich wykorzystanie, korzystając z tego zasobu:
    /organizations/{org_name}/transactions, gdzie {org_name} to nazwa organizacji.

    Uwaga: jeśli deweloper nie ma jeszcze transakcji, możesz pominąć ten krok.

    Zasób transactions wstawia jedną transakcję, która odzwierciedla bieżące wykorzystanie transakcji, i aktualizuje wszystkie liczniki wewnętrzne, aby odzwierciedlały tę nową wartość.

    Jeśli na przykład deweloper wywołał 1000 wywołań interfejsu API przed migracją, aby przechwycić bieżące działanie, możesz ustawić wykorzystanie transakcji na 1000, wywołując zasób transactions i ustawiając we właściwości batchSize wartość 1000 w treści żądania.

    W tabeli poniżej znajdziesz podsumowanie właściwości konfiguracji, które możesz określić w treści żądania, aby ręcznie ustawić liczbę transakcji, ich wartości domyślne oraz informację, czy są one wymagane.

    Właściwość Opis Domyślne Wymagana?
    application

    Identyfikator aplikacji dewelopera.

    Nie dotyczy Tak
    batchSize

    Liczba transakcji do przeniesienia.

    1 Nie
    custAttn

    Wartość atrybutu niestandardowego używanego z partSize do obliczania wykorzystania transakcji.

    Numer niestandardowego atrybutu w wiadomości musi być dodatnią liczbą całkowitą lub dziesiętną (do 4 miejsc po przecinku). Wartości ujemne są niedozwolone.

    Atrybut niestandardowy musi być zdefiniowany w:

    Nie dotyczy Tak
    product

    Identyfikator usługi API.

    Nie dotyczy Tak
    type

    Musi być ustawiona wartość CHARGE (jest to wartość domyślna).

    CHARGE Nie

    Aby pominąć etapy weryfikacji i wymusić ustawienie liczby transakcji, ustaw parametr zapytania force na true (np. ?force=true). Domyślnie wykonywane są ?force=false i kroki weryfikacji. Jeśli na przykład deweloper przedpłaconego dewelopera ma zerowe saldo, a aktywność na koncie zostanie zawieszona, to ?force=false podczas weryfikacji żądanie nie powiedzie się.

    Na przykład to żądanie ustawia liczbę transakcji na 50 dla określonej aplikacji i usługi API:

    $ curl -H "Content-Type:application/json" -X POST -d \
    '{ 
       "application":{
         "id":"6a9b1afc-2110-43d6-bae7-1b137aecb05b"
       },
       "product":{
         "id":"testproduct"
       },
       "batchSize":50
    }' \
    "https://api.enterprise.apigee.com/v1/mint/organizations/myOrg/transactions" \
    -u email:password
    

    Poniższe żądanie ustawia wykorzystanie transakcji na 12.5 przez określoną aplikację i usługę API. W żądaniu batchSize jest ustawiona na 125, a wartość pierwszego atrybutu niestandardowego zdefiniowanego dla produktu z interfejsem API to 0.1. Po pomnożeniu przez siebie 125 * 0,1 daje 12,5.

    $ curl -H "Content-Type:application/json" -X POST -d \
    '{ 
       "application":{
         "id":"6a9b1afc-2110-43d6-bae7-1b137aecb05b"
       },
       "product":{
         "id":"testproduct"
       },
       "batchSize": 125,
       "custAtt1" : 0.1
    }' \
    "https://api.enterprise.apigee.com/v1/mint/organizations/myOrg/transactions" \
    -u email:password
    
  7. Jeśli deweloper nie został obciążony niezbędnymi opłatami konfiguracyjnymi lub cyklicznymi, możesz ręcznie pobrać opłatę konfiguracyjną lub cykliczną za abonament, korzystając z tego zasobu:
    /organizations/{org_name}/transactions, gdzie {org_name} to nazwa organizacji.

    Uwaga: jeśli deweloper został już obciążony opłatą konfiguracyjną lub cykliczną, możesz pominąć ten krok. Wywołanie zasobu transactions nie ma wpływu na konfigurację ani opłaty cykliczne określone w abonamencie.

    W tabeli poniżej znajdziesz podsumowanie właściwości konfiguracji, które możesz określić w treści żądania, aby ręcznie naliczać opłaty konfiguracyjne lub cykliczne za korzystanie z abonamentu, ich wartości domyślne oraz informację, czy są one wymagane.

    Właściwość Opis Domyślne Wymagana?
    currency

    Waluta używana w planie stawek. Podaj kod ISO 4217 waluty, np. USD dla polskiego złotego czy frank szwajcarski.

    Nie dotyczy Tak
    developer

    Identyfikator dewelopera.

    Nie dotyczy Tak
    rate

    Opłata konfiguracyjna lub cykliczna do obciążenia.

    Nie dotyczy Tak
    ratePlan

    Identyfikator planu stawek.

    Nie dotyczy Tak
    type

    Ustaw jako SETUPFEES lub RECURRINGFEES

    CHARGE Tak

    Aby pominąć etapy weryfikacji i wymusić pobranie opłaty, ustaw parametr zapytania force na true (np. ?force=true). Domyślnie wykonywane są ?force=false i kroki weryfikacji. Jeśli na przykład deweloper przedpłaconego dewelopera ma zerowe saldo, a aktywność na koncie zostanie zawieszona, żądanie ?force=false podczas weryfikacji zakończy się niepowodzeniem.

    Na przykład to żądanie powoduje naliczenie opłaty konfiguracyjnej w wysokości 10 USD deweloperowi, który ma abonament na abonament:

    $ curl -H "Content-Type:application/json" -X POST -d \
    '{ 
       "developer":{
         "id":"dev1@myorg.com"
       },
       "currency":{
         "id":"usd"
       },
       "ratePlan":{
         "id":"mypackage_rateplan1"
       },   
       "rate":10,
       "type":"SETUPFEES"
    }' \
    "https://api.enterprise.apigee.com/v1/mint/organizations/myOrg/transactions" \
    -u email:password