Przenoszenie deweloperów do generowania przychodu

Przeglądasz dokumentację Apigee Edge.
Przejdź do Dokumentacja Apigee X.
informacje.

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

  1. 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:
  2. Opublikuj plany stawek w sposób opisany w artykule Publikowanie planów stawek.
  3. Dodaj nowych deweloperów do organizacji w sposób opisany w artykule Rejestrowanie deweloperów aplikacji.
  4. Uzupełniaj saldo z przedpłaty w przypadku każdego dewelopera w sposób opisany w artykule Zarządzanie kontem przedpłaconym.
  5. 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 do true.

  6. 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:

    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 adres true (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
    
  7. 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 lub RECURRINGFEES

    CHARGE Tak

    Aby pominąć kroki weryfikacji i wymusić opłatę, ustaw zapytanie force do true (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