Przeglądasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. Informacje
W tym temacie znajdziesz informacje i wskazówki dotyczące rozwiązywania typowych problemów z zarabianiem.
Deweloper jest zawieszony
Krótki opis problemu
Deweloper jest zawieszony i nie będzie mógł wykonywać żadnych dodatkowych transakcji umożliwiających generowanie przychodu ani wywołać interfejsu API.
Komunikaty o błędach
<error>
<messages>
<message>Exceeded developer limit configuration -</message>
<message>Is Developer Suspended - true</message>
</messages>
</error>
Diagnostyka
Aby określić przyczynę zawieszenia dewelopera, wykonaj te czynności:
- Wykonaj to wywołanie interfejsu API, aby zidentyfikować kod błędu powiązany z zawieszonym deweloperem:
- Jeśli jesteś użytkownikiem chmury publicznej, użyj tego interfejsu API:
curl -X GET "https://api.enterprise.apigee.com/v1/mint/organizations/{org}/suspended-developers/{developer-email}" -u orgadminEmail:password - Jeśli jesteś użytkownikiem chmury prywatnej, użyj tego interfejsu API:
curl -X GET "http://<management-host>:<port#>/v1/mint/organizations/{org}/suspended-developers/{developer-email}" -u orgadminEmail:password
- Jeśli jesteś użytkownikiem chmury publicznej, użyj tego interfejsu API:
- Aby ustalić, dlaczego deweloper został zawieszony, porównaj kod błędu z tymi kodami przyczyn.
Zobacz też: Podsumowanie kodów przyczyn zawieszenia deweloperów
|
Kod przyczyny |
Przyczyna |
Szczegóły |
|
INSUFFICIENT_FUNDS |
Saldo konta dewelopera zostało wyczerpane |
Deweloper zostanie zawieszony, jeśli na saldzie przedpłaconego konta dewelopera nie będzie wystarczających środków na kolejne transakcje. W przypadku deweloperów korzystających z opcji płatności po wykonaniu usługi ten błąd może wystąpić, gdy przekroczą limit kredytowy lub limit kredytu ustawiony w użytej walucie, zostanie wyczerpany. |
|
LIMIT_VIOLATED RATE_PLAN_RATE_BAND_EXCEEDED |
Deweloper nie może dokonywać kolejnych transakcji |
Każdy deweloper może dokonywać stałej liczby transakcji na podstawie zakupionego abonamentu. Jeśli liczba transakcji zostanie przekroczona, deweloper zostanie zawieszony i nie będzie mógł zrealizować kolejnych. |
|
NO_CURRENT_PUBLISHABLE_ENTITY |
Deweloper nie kupił żadnego abonamentu |
Przed dokonaniem transakcji deweloper musi kupić plan stawek. |
Rozdzielczość
|
Błąd |
Kroki do rozwiązania |
|
INSUFFICIENT_FUNDS |
Deweloper musi sprawdzić, czy na koncie jest wystarczające saldo lub dostępne środki, aby móc zrealizować dodatkowe transakcje. |
|
LIMIT_VIOLATED RATE_PLAN_RATE_BAND_EXCEEDED |
|
|
NO_CURRENT_PUBLISHABLE_ENTITY |
Aby móc wywoływać interfejs API, deweloper musi kupić abonament. |
Problemy z konfiguracją ustawień zarabiania
Objawy
Problemy z konfiguracją funkcji zarabiania mogą przejawiać się różnymi objawami, takimi jak:
- Funkcja webhooków nie działa
- Nie można utworzyć webhooków
- Powiadomienia webhooka nie są aktywowane
- Raporty o przychodach nie zawierają żadnych transakcji. Na przykład dane Analytics wskazują, że deweloper zrealizował w danym okresie wiele transakcji, ale w raportach Generowanie przychodu nie ma żadnej z nich.
- Transakcje nie są rejestrowane
Komunikaty o błędach
Możesz nie widzieć żadnych komunikatów o błędach, ale będą widoczne problemy opisane w sekcji Objawy.
Możliwe przyczyny
Jeśli widzisz którykolwiek z objawów wymienionych w sekcji Objawy, prawdopodobnie transakcje nie są wykorzystywane do zarabiania.
Diagnozowanie przyczyny
-
Aby sprawdzić, czy transakcje są wykorzystywane do zarabiania, użyj wywołania interfejsu API zarządzania opisanego w poniższej sekcji.
- Jeśli w tym czasie nie zobaczysz żadnych transakcji oznaczonych jako SUCCESS, oznacza to, że nie generujesz przychodów.
Typowe przyczyny takiej sytuacji to:
- Zasada sprawdzania limitów zarabiania nieprzyłączona do serwera proxy interfejsu API
- APIProduct nie generuje przychodów
- Nieprawidłowo zdefiniowane zasady rejestrowania transakcji
- Deweloper nie kupił abonamentu
Poniżej opisujemy, jak diagnozować i rozwiązywać każdy problem.
Zasady sprawdzania limitów zarabiania nie są używane na serwerze proxy interfejsu API
Diagnostyka
- Sprawdź, czy do serwerów proxy interfejsu API jest podłączona zasada sprawdzania limitów zarabiania.
- Jeśli zasady nie są dołączone, może to być powodem, dla którego transakcje są oznaczone jako FAILED.
Rozdzielczość
Dołącz zasadę sprawdzania limitów zarabiania do wymaganych serwerów proxy interfejsu API, zgodnie z opisem w sekcji Egzekwowanie limitów zarabiania na serwerach proxy interfejsu API.
Jeśli problem będzie się powtarzał, sprawdź, czy Usługa API nie zarabia.
Usługa API nie generuje przychodów
Diagnostyka
- Sprawdź, czy generuje ona przychody (tylko usługi API generujące przychody są oceniane i uwzględniane w sekcji Transakcje). Produkt, na którym zarabiasz, to taki, w którym dostępny jest co najmniej 1 aktywny abonament.
- Aby uzyskać listę produktów, na których zarabiasz, użyj tego wywołania interfejsu API zarządzania:
- Jeśli jesteś użytkownikiem chmury publicznej, użyj tego interfejsu API:
curl -v https://api.enterprise.apigee.com/v1/mint/organizations/{org_id}/products?monetized=true -u orgadminEmail:password - Jeśli jesteś użytkownikiem chmury prywatnej, użyj tego interfejsu API:
curl -v http://<management-host>:<port#>/v1/mint/organizations/{org_id}/products?monetized=true -u orgadminEmail:password
- Jeśli jesteś użytkownikiem chmury publicznej, użyj tego interfejsu API:
- Jeśli usługa API powiązana z Twoim serwerem proxy interfejsu API nie generuje przychodów, może to być przyczyną, dla której transakcje nie generują przychodów.
Rozdzielczość
Aby zarabiać na usłudze API:
- Skonfiguruj zasadę rejestrowania transakcji.
- Sprawdź, czy usługa API ma aktywny abonament.
Jeśli problem będzie się powtarzać, sprawdź Nieprawidłowo zdefiniowane zasady rejestrowania transakcji.
Nieprawidłowo zdefiniowane zasady rejestrowania transakcji
Diagnostyka
- Włącz śledzenie UI dla serwera proxy interfejsu API, do którego dołączono zasadę sprawdzania limitów zarabiania.
- Wybierz konkretne żądanie do interfejsu API ze śledzenia UI.
- Wybierz proces AX Analytics i sprawdź, czy te zmienne przepływu zarabiania (minuty) mają odpowiednie wartości:
mint.tx.status - Should match the value set up for "success criteria" in the transaction recording policy for the API product being used. When tracing, the txProviderStatus in the transaction recording policy is stored in the variable 'mint.tx.status'. mint.tx.app_id - Application id of API product. mint.tx.prod_id - API product id.
Oto przykładowy zrzut interfejsu użytkownika, który pokazuje, że zmienne przepływu tworzenia są prawidłowo skonfigurowane.
- Jeśli zauważysz błąd w zmiennej
mint.tx.status, oznacza to, że zasada rejestrowania transakcji jest nieprawidłowo zdefiniowana.
Rozdzielczość
- Upewnij się, że podczas tworzenia zasady rejestrowania transakcji prawidłowo wykonano wszystkie czynności opisane w sekcji Tworzenie zasady rejestrowania transakcji.
- Wartością klucza są „kryteria powodzenia transakcji” określone w zasadzie rejestrowania transakcji. Zobacz przykłady ustawiania kryteriów powodzenia transakcji w zasadach rejestrowania transakcji.
Deweloper nie kupił abonamentu
Diagnostyka
- Aby sprawdzić plany stawek kupione przez dewelopera, użyj tego wywołania interfejsu API zarządzania:
- Jeśli jesteś użytkownikiem chmury publicznej, użyj tego interfejsu API:
curl -v https://api.enterprise.apigee.com/v1/mint/organizations/{org}/developers/{dev_email}/products/{prod}/developer-rateplans -u orgadminEmail:password - Jeśli jesteś użytkownikiem Private Cloud, użyj tego interfejsu API:
curl -v http://<management-host>:<port#>/v1/mint/organizations/{org}/developers/{dev_email}/products/{prod}/developer-rateplans -u orgadminEmail:password
- Jeśli jesteś użytkownikiem chmury publicznej, użyj tego interfejsu API:
- Na podstawie odpowiedzi z powyższego wywołania znajdź abonament, który był aktywny w czasie realizacji transakcji przez dewelopera.
Rozdzielczość
Programista musi kupić plan stawek zgodnie ze swoimi wymaganiami, a następnie wykonać transakcje lub interfejsy API.
Jeśli problem będzie nadal występował, skontaktuj się z zespołem pomocy Apigee Edge.