Przenoszenie deweloperów do generowania przychodu

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

Jeśli masz deweloperów, których chcesz przenieść do funkcji Zarabianie:

  1. Utwórz produkty API, pakiety API i taryfy dla programistów, których migrujesz, jeśli jeszcze ich nie ma. Więcej informacji:
  2. Opublikuj plany cenowe zgodnie z instrukcjami podanymi w artykule Opublikowanie planów cenowych.
  3. Dodaj nowych deweloperów do organizacji, postępując zgodnie z instrukcjami w artykule Rejestracja deweloperów aplikacji.
  4. Doładuj saldo przedpłacone każdego dewelopera zgodnie z opisem w artykule Zarządzanie saldami kont przedpłaconych.
  5. Zaakceptuj plan taryfowy zgodnie z opisem w artykule Kupowanie planów taryfowych za pomocą interfejsu API.

    Uwaga: aby zrezygnować z opłat za konfigurację, jeśli zostały już naliczone, ustaw parametr zapytania waivefees na true.

  6. Jeśli deweloper, którego dane migrujesz, ma już transakcje, możesz ręcznie przenieść użycie transakcji za pomocą tego zasobu:
    /organizations/{org_name}/transactions, gdzie {org_name} to nazwa organizacji.

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

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

    Jeśli na przykład przed migracją deweloper wysłał 1000 wywołań interfejsu API, w celu rejestrowania bieżącej aktywności możesz ustawić wykorzystanie transakcji na 1000, wywołując zasób transactions i ustawiając właściwość batchSize na 1000 w treści żądania.

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

    Właściwość Opis Domyślny Wymagany?
    application

    Identyfikator aplikacji dewelopera.

    		 Nie dotyczy Tak
    batchSize

    Liczba transakcji, które chcesz przenieść.

    		 1 Nie
    custAttn

    Wartość atrybutu niestandardowego, który jest używany z opcją wsadowego rozmiaru do obliczania wykorzystania transakcji.

    Numer atrybutu niestandardowego w wiadomości musi być podany jako dodatnia liczba całkowita lub dziesiętna (z maksymalnie 4 miejscami po przecinku). Wartości ujemne są niedozwolone.

    Atrybut niestandardowy musi być zdefiniowany w:

    		 Nie dotyczy Tak
    product

    Identyfikator produktu interfejsu API.

    		 Nie dotyczy Tak
    type

    Musi być ustawiona na CHARGE (domyślne).

    		 CHARGE Nie

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

    Na przykład to żądanie ustawia liczbę transakcji na 50 w przypadku określonej aplikacji i produktu w interfejsie 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

    W następującym żądaniu ustawiamy wykorzystanie transakcji na 12,5 dla określonej aplikacji i produktu w interfejsie API. W żądaniu parametr batchSize ma wartość 125, a wartość pierwszego atrybutu niestandardowego zdefiniowanego dla produktu API to 0.1. Po pomnożeniu przez 125 * 0,1 daje to 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 deweloperowi nie zostały naliczone niezbędne opłaty za konfigurację lub opłaty cykliczne, możesz ręcznie naliczać opłaty za konfigurację lub opłaty cykliczne za abonament za pomocą 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 będzie miało 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łatę za konfigurację lub opłatę okresową za plan taryfowy, ich wartości domyślne oraz informacje o tym, czy są wymagane.

    Właściwość Opis Domyślny Wymagany?
    currency

    Waluta używana w planie stawek. Podaj kod waluty ISO 4217, np. usd w przypadku dolara amerykańskiego lub chf w przypadku franka szwajcarskiego.

    		 Nie dotyczy Tak
    developer

    Identyfikator dewelopera.

    		 Nie dotyczy Tak
    rate

    opłata za konfigurację lub opłata cykliczna.

    		 Nie dotyczy Tak
    ratePlan

    Identyfikator abonamentu.

    		 Nie dotyczy Tak
    type

    Ustaw jako SETUPFEES lub RECURRINGFEES

    		 CHARGE Tak

    Aby pominąć etapy weryfikacji i przymusowo obciążyć klienta opłatą, ustaw parametr zapytania force na true (na przykład ?force=true). Domyślnie wykonywane są etapy ?force=false i weryfikacji. Jeśli na przykład deweloper korzystający z przedpłaty ma saldo 0 i jego konto jest zawieszone, ?force=false prośba zostanie odrzucona podczas weryfikacji.

    Na przykład w ramach tego żądania deweloper, który subskrybuje abonament, zostanie obciążony opłatą za konfigurację w wysokości 10 USD:

    $ 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