Przeglądasz dokumentację Apigee Edge.
Przejdź do
Dokumentacja Apigee X. informacje.
Jeśli masz deweloperów, których chcesz przenieść do funkcji Zarabianie:
- Twórz usługi API, pakiety API i plany stawek dla deweloperów, z którymi współpracujesz migracji, jeśli jeszcze nie istnieją. Więcej informacji:
- Opublikuj plany stawek w sposób opisany w artykule Publikowanie planów stawek.
- Dodaj nowych deweloperów do organizacji w sposób opisany w artykule Rejestrowanie deweloperów aplikacji.
- Uzupełniaj saldo z przedpłaty w przypadku każdego dewelopera w sposób opisany w artykule Zarządzanie kontem przedpłaconym.
- Zaakceptuj plan stawek zgodnie z opisem w sekcji Współczynnik zakupów.
za pomocą interfejsu API.
Uwaga: aby zrezygnować z opłat konfiguracyjnych, jeśli deweloper został już obciążony opłatą, ustaw
waivefees
parametr zapytania dotrue
. - Jeśli przenoszony programista ma już transakcje,
możesz ręcznie przenieść wykorzystanie transakcji za pomocą tego zasobu:
/organizations/{org_name}/transactions
, gdzie{org_name}
to nazwa organizacji.Uwaga: jeśli deweloper nie ma jeszcze transakcji, możesz to pominąć. krok po kroku.
Zasób
transactions
wstawia pojedynczą transakcję, która odzwierciedla bieżącego wykorzystania transakcji i aktualizuje wszystkie wewnętrzne liczniki, aby odzwierciedlić tę nową wartość.Jeśli na przykład przed migracją deweloper opublikował 1000 wywołań interfejsu API, przechwytywać bieżącą aktywność. Możesz ustawić wykorzystanie transakcji na 1000, wywołując metodę
transactions
zasób i ustawiam właściwośćbatchSize
na 1000 w treść żądania.W tabeli poniżej znajdziesz podsumowanie właściwości konfiguracji, które możesz określić w polu treść żądania o ręczne ustawienie liczby transakcji, ich wartości domyślnych oraz tego, czy nie są wymagane.
Właściwość Opis Domyślny Wymagana? 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 wsadem wsadowym do obliczania wykorzystanie transakcji.
Numer atrybutu niestandardowego w wiadomości musi być określony jako dodatnia całość lub dziesiętną (do czterech miejsc po przecinku). Wartości ujemne są niedozwolone.
Atrybut niestandardowy musi być zdefiniowany w:
- Zasady rejestrowania transakcji w usłudze API. Zobacz Konfigurowanie zasad rejestrowania transakcji.
- Aktywny plan opłat za usługę API. Patrz sekcja Konfigurowanie. plan stawek z atrybutami niestandardowymi.
Nie dotyczy Tak product
Identyfikator usługi API.
Nie dotyczy Tak type
Należy ustawić wartość
CHARGE
(jest to wartość domyślna).CHARGE
Nie Aby pominąć kroki weryfikacji i wymusić liczbę transakcji, ustaw parametr Parametr zapytania
force
na adrestrue
(np.?force=true
). Domyślnie?force=false
oraz kroki weryfikacji to . Na przykład jeśli deweloper korzystający z przedpłaty ma na koncie zerowe saldo i aktywność jest zawieszone, jeśli?force=false
, żądanie zakończy się niepowodzeniem podczas weryfikacji.Na przykład to żądanie ustawia liczbę transakcji na 50 dla określonego 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
To żądanie ustawia wykorzystanie transakcji na 12,5 dla określonej aplikacji oraz i usługa API. W żądaniu
batchSize
ma wartość125
, a wartość dla pierwszego atrybutu niestandardowego zdefiniowanego dla produktu API ma wartość0.1
. Kiedy pomnożonego przez siebie, 125 * 0,1 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
- Jeśli deweloper nie został obciążony opłatą za niezbędną konfigurację lub cyklicznie,
naliczaj opłatę instalacyjną lub cykliczną za abonament, korzystając z tych zasobów:
/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 pomiń ten krok. Wywołanie zasobu
transactions
nie będzie miało wpływu na konfigurację lub opłaty cykliczne określone w planie stawek.W tabeli poniżej znajdziesz podsumowanie właściwości konfiguracji, które możesz określić w polu treść żądania, aby ręcznie pobrać opłatę konfiguracyjną lub cykliczną za plan stawek; jest to domyślna kwota oraz określić, czy są wymagane.
Właściwość Opis Domyślny Wymagana? currency
Waluta używana w planie stawek. Podaj kod ISO 4217 dla waluty, np. usd w przypadku dolara amerykańskiego lub chf dla franka szwajcarskiego.
Nie dotyczy Tak developer
Identyfikator dewelopera.
Nie dotyczy Tak rate
Opłata konfiguracyjna lub cykliczna do pobrania.
Nie dotyczy Tak ratePlan
Identyfikator abonamentu.
Nie dotyczy Tak type
Ustaw jako
SETUPFEES
lubRECURRINGFEES
CHARGE
Tak Aby pominąć kroki weryfikacji i wymusić opłatę, ustaw zapytanie
force
dotrue
(np.?force=true
). Domyślnie Wykonano?force=false
i kroki weryfikacji. Na przykład, jeśli konto przedpłacone deweloper ma saldo zerowe, a aktywność na koncie jest zawieszona, jeśli?force=false
żądanie zakończy się niepowodzeniem podczas weryfikacji.Na przykład poniższe żądanie pobiera opłatę konfiguracyjną w wysokości 10 USD na rzecz deweloper zasubskrybował 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