Zarejestruj deweloperów aplikacji

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

Rejestruj deweloperów aplikacji i nimi zarządzaj w sposób opisany w sekcjach poniżej. (Rejestracja aplikacji to osobny proces opisany w artykule Rejestrowanie aplikacji i zarządzanie kluczami interfejsu API).

Wprowadzenie

Edge zapewnia wiele korzyści, które są całkowicie zależne od tego, kto wywołuje Twoje interfejsy API. Na przykład bezpieczeństwo interfejsu API, zarządzanie ruchem i spora ilość danych analitycznych zależą od tego, kto wywołuje interfejs. A skąd Edge wie, kto wywołuje Twoje interfejsy API? Odczytując unikalne informacje w każdym wywołaniu interfejsu API, takie jak identyfikator użytkownika, klucz interfejsu API lub token OAuth. Te unikalne informacje blokują lub odblokowują funkcje wbudowane w proxy interfejsu API, co daje Ci pełną kontrolę nad dostępem do interfejsu API i jego działaniem.

Dlatego deweloperzy aplikacji muszą się zarejestrować, aby korzystać z Twoich interfejsów API. Po dodaniu deweloperzy rejestrują swoje aplikacje, wybierają interfejsy API, których chcą używać, i otrzymują unikalne dane uwierzytelniające interfejs API (klucze i tajne kody konsumenta) potrzebne do uzyskania dostępu do Twoich interfejsów API.

Rejestrowanie deweloperów aplikacji

Zarejestruj deweloperów aplikacji, korzystając z jednej z tych metod:

Zalecenia dotyczące zarządzania kontami deweloperów w portalach deweloperów

Apigee zaleca zarządzanie kontami deweloperów bezpośrednio w portalu dla programistów.

Jeśli korzystasz ze zintegrowanego portalu, jest to jedyny sposób, aby zapewnić synchronizację kont deweloperów w zintegrowanym portalu i Edge.

Jeśli korzystasz z portalu dla programistów opartego na Drupalu, zarządzanie kontami programistów bezpośrednio w portalu dla programistów zapewnia te korzyści:

  • Gdy dodasz dewelopera za pomocą interfejsu administratora w portalu, możesz ustawić jego hasło do portalu i wywołać automatyczne wysłanie e-maila do dewelopera.

    Podczas dodawania lub modyfikowania dewelopera za pomocą Edge nie jest wysyłany do niego e-mail i nie możesz ustawić hasła dewelopera w portalu. Dlatego deweloper musi zresetować hasło w portalu, zanim będzie mógł się w nim zalogować.

  • Wszelkie zmiany wprowadzone na koncie dewelopera w portalu są automatycznie wysyłane do Edge.

Jeśli zdecydujesz się zarządzać kontami deweloperów opartymi na Drupalu za pomocą Edge, musisz zsynchronizować deweloperów aplikacji między portalem a Edge.

Przeglądanie strony Deweloperzy

Otwórz i przejrzyj stronę Deweloperzy w interfejsie Edge i nowym interfejsie Edge.

Edge

Aby otworzyć stronę Deweloperzy w interfejsie Edge:

  1. Zaloguj się na apigee.com/edge.
  2. Na pasku nawigacyjnym po lewej stronie kliknij Opublikuj > Deweloperzy.

Wyświetli się strona Deweloperzy.

Jak widać na ilustracji, strona Deweloperzy umożliwia:

Nowy interfejs Edge (chmura prywatna)

Aby otworzyć stronę Deweloperzy w nowym interfejsie Edge:

  1. Zaloguj się w interfejsie New Edge UI na stronie http://host:3001/edge, gdzie host to adres IP lub nazwa DNS hosta, na którym działa interfejs New Edge UI.
  2. Na pasku nawigacyjnym po lewej stronie kliknij Opublikuj > Deweloperzy.

Wyświetli się strona Deweloperzy.

Strona dla programistów w nowym interfejsie Edge

Jak widać na ilustracji, strona Deweloperzy umożliwia:

Dodawanie dewelopera

Aby dodać dewelopera:

  1. Otwórz stronę Deweloperzy.
  2. Kliknij + Deweloper.
  3. Wpisz dane dewelopera, w tym imię, nazwisko, adres e-mail i nazwę użytkownika.
  4. Kliknij Utwórz.

Wyświetlanie i edytowanie szczegółów dewelopera

Wyświetlanie i edytowanie szczegółów dewelopera. W przypadku organizacji, w których włączono zarabianie, możesz edytować atrybuty niestandardowe zarabiania zdefiniowane w artykule Konfigurowanie atrybutów zarabiania.

Aby wyświetlić i edytować szczegóły dewelopera:

  1. Otwórz stronę Deweloperzy.
  2. Kliknij wiersz dewelopera, którego chcesz wyświetlić i edytować, aby otworzyć jego szczegóły.
  3. W sekcji Szczegóły wyświetlają się te informacje: W razie potrzeby edytuj szczegóły dewelopera.
    Szczegóły Opis
    Szczegóły imię i nazwisko dewelopera, nazwa użytkownika i adres e-mail; stan i czas trwania rejestracji oraz identyfikator dewelopera.
    Aby edytować informacje o deweloperze, kliknij dowolne z tych pól:
    • Imię
    • Nazwisko
    • E-mail
    • Nazwa użytkownika
     Zmodyfikuj treść i naciśnij Enter, aby potwierdzić zmianę.
    Atrybuty niestandardowe Atrybuty niestandardowe zdefiniowane dla dewelopera. W razie potrzeby skonfiguruj atrybuty niestandardowe. Więcej informacji znajdziesz w tych artykułach:
    Aplikacje Aplikacje zarejestrowane przez dewelopera. Więcej informacji znajdziesz w artykule Rejestrowanie aplikacji.
  4. Aktywuj lub dezaktywuj dewelopera w polu Stan.
    Więcej informacji znajdziesz w artykule Aktywowanie i dezaktywowanie dewelopera.

W przypadku Apigee Edge na platformie Public Cloud Edge przechowuje w pamięci podręcznej te elementy przez co najmniej 180 sekund od momentu uzyskania do nich dostępu:

  • tokeny dostępu OAuth, Oznacza to, że odwołany token może być nadal ważny przez maksymalnie 3 minuty, dopóki nie wygaśnie limit pamięci podręcznej.
  • podmioty Key Management Service (KMS) (aplikacje, programiści, usługi API);
  • atrybuty niestandardowe w tokenach OAuth i elementach KMS;

Zarządzanie atrybutami niestandardowymi dewelopera

Możesz dodać maksymalnie 18 atrybutów niestandardowych dla każdego dewelopera, w tym atrybuty zarabiania opisane w artykule Konfigurowanie atrybutów zarabiania.

Aby zarządzać atrybutami niestandardowymi:

  1. Otwórz stronę Deweloperzy.
  2. Kliknij wiersz dewelopera, w przypadku którego chcesz zarządzać atrybutami niestandardowymi, aby otworzyć szczegóły dewelopera.
  3. W sekcji Atrybuty niestandardowe kliknij +.
  4. Wpisz nazwę i wartość atrybutu.
  5. Kliknij .
  6. Aby usunąć atrybut niestandardowy, umieść kursor nad atrybutem i w menu czynności kliknij .

Aktywowanie i dezaktywowanie dewelopera

Gdy deweloper aplikacji zarejestruje się samodzielnie w Twoim portalu, możesz skonfigurować, czy ma być domyślnie aktywny.

Gdy deweloper jest nieaktywny, nadal może logować się w portalu dla programistów i tworzyć aplikacje, ale żaden z odpowiednich kluczy interfejsu API nie będzie działać. Aplikacje dewelopera nadal mają stan zatwierdzony (lub inny), podobnie jak klucze interfejsu API, mimo że nie są one ważne, gdy deweloper jest nieaktywny.

Aby aktywować lub dezaktywować dewelopera:

  1. Otwórz stronę Deweloperzy.
  2. Kliknij wiersz dewelopera, którego chcesz aktywować lub dezaktywować, aby otworzyć jego szczegóły.
  3. W sekcji Szczegóły ustaw w polu Stan wartość Aktywny lub Nieaktywny.
  4. Jeśli deweloper należy do kilku organizacji, powtórz te czynności.

Eksportowanie danych o publikacji

Wyeksportuj te dane publikowania w formacie pliku CSV (wartości rozdzielone przecinkami):

  • Dane programisty
  • Szczegóły dewelopera, aplikacji i usługi API

Aby wyeksportować dane o publikowaniu:

  1. Otwórz stronę Deweloperzy.
  2. Kliknij Eksportuj plik CSV...
  3. W menu kliknij Deweloperzy lub Deweloperzy, aplikacje i usługi.

Wybrane dane o publikowaniu zostaną pobrane jako plik CSV.

Usuwanie dewelopera

Aby usunąć dewelopera:

  1. Otwórz stronę Deweloperzy.
  2. Umieść kursor na wierszu dewelopera, którego chcesz usunąć, aby wyświetlić menu czynności.
  3. Kliknij .
  4. Kliknij Usuń, aby potwierdzić tę czynność.

Synchronizowanie deweloperów aplikacji między portalem a Edge

Jeśli do publikowania interfejsów API używasz portalu dla programistów opartego na Drupalu, zmiany wprowadzone w Edge w przypadku programistów aplikacji nie są propagowane do portalu. Aby zmiany pojawiły się w portalu, musisz zalogować się w nim jako administrator i zsynchronizować go z Edge.

.

Aby zsynchronizować portal dla programistów z deweloperami aplikacji zdefiniowanymi w Edge, zapoznaj się z tymi sekcjami:

Grupowanie deweloperów w firmy

W przypadku generowania przychodu firma to zbiór deweloperów zarządzanych jako pojedynczy podmiot. Firma może być dowolną grupą odpowiednią dla Twojej organizacji, np. jednostką biznesową, linią produktów lub działem. Grupowanie deweloperów w firmy jest przydatne, gdy chcesz powiązać wielu deweloperów z jednym podmiotem prawnym. Może to być konieczne na przykład w celach rozliczeniowych. Deweloperzy w Twojej organizacji nie muszą być jednak powiązani z firmą. Pamiętaj, że deweloper jest zawsze pojedynczym podmiotem, jednoznacznie identyfikowanym przez element adresu e-mail. Jeśli deweloper jest częścią firmy, na stronie Deweloperzy zobaczysz nazwę firmy.

Więcej informacji o zarządzaniu firmami i deweloperami w celu zarabiania znajdziesz w artykule Zarządzanie firmami i deweloperami.

Konfigurowanie atrybutów zarabiania

Podczas edytowania dewelopera w interfejsie lub tworzenia bądź edytowania dewelopera za pomocą interfejsu API możesz skonfigurować właściwości zarabiania zdefiniowane w tabeli poniżej. Początkowo właściwości zarabiania dla organizacji konfiguruje się podczas edytowania profilu organizacji.

Nazwa pola Nazwa atrybutu niestandardowego Opis
Adres MINT_DEVELOPER_ADDRESS

Adres dewelopera, w tym te pola: Adres (wiersze 1 i 2), Miasto, Stan, Kod pocztowy i Kraj.

Profil płatności MINT_BILLING_PROFILE

Cykl rozliczeniowy organizacji. Prawidłowe wartości:

  • PRORATED: rozliczenia są oparte na liczbie dni, w których produkt API jest używany w danym miesiącu kalendarzowym.
  • CALENDAR_MONTH: Rozliczenia są dokonywane co miesiąc.
Typ płatności MINT_BILLING_TYPE

Model płatności dla deweloperów używany do rozliczeń. Wartość może być jedną z tych opcji:

  • PRZEDPŁATA: deweloper płaci z góry za korzystanie z produktu API. Środki są odliczane od salda dewelopera, gdy używany jest produkt interfejsu API. Deweloper musi utrzymywać saldo z przedpłaty wystarczające do zakupu produktu API.
  • POSTPAID: Deweloper otrzymuje co miesiąc fakturę za korzystanie z usług API. Deweloper płaci za korzystanie z usług API zgodnie z warunkami płatności określonymi w planach uwzględnionych na fakturze.
  • BOTH: obsługuje oba typy rozliczeń. Domyślna wartość to PREPAID.

Zobacz Konfigurowanie typów rozliczeń przedpłaconych i po wykonaniu usługi za pomocą interfejsu API.

Kategoria MINT_DEVELOPER_CATEGORY Kategoria dewelopera, do której chcesz dodać dewelopera. Kategoria deweloperów to grupa deweloperów lub firm o podobnych cechach. Więcej informacji znajdziesz w artykule Zarządzanie kategoriami deweloperów.
Identyfikator firmy MINT_COMPANY_ID Identyfikator firmy (w odpowiednich przypadkach). Więcej informacji znajdziesz w artykule Grupowanie deweloperów w firmy.
Typ dewelopera MINT_DEVELOPER_TYPE Apigee nie używa tej właściwości.

Typ dewelopera. Prawidłowe wartości to: TRUSTED lub UNTRUSTED

Is Broker MINT_IS_BROKER Flaga określająca, czy przychody są oparte na wartości netto.
Imię i nazwisko MINT_DEVELOPER_LEGAL_NAME Nazwa prawna dewelopera, która będzie używana we wszystkich raportach.
Uwaga: ten atrybut jest wymagany, jeśli deweloper nie jest powiązany z firmą i chce subskrybować opublikowany plan cenowy.
Samofakturowanie MINT_HAS_SELF_BILLING Flaga określająca, czy faktury wystawiane samodzielnie są włączone. Jeśli ta opcja jest włączona (true), zarabianie generuje fakturę z samofakturowaniem zamiast wyciągu z udziałem w przychodach. Faktura wystawiona samodzielnie to dokument finansowy, który zawiera szczegółowe informacje o kwocie należnej deweloperowi. Działa ona jako faktura dla dostawcy interfejsu API w imieniu dewelopera.
Numer autoryzacji zwolnienia z podatku MINT_TAX_EXEMPT_AUTH_NO Numer zwolnienia z podatku dla podmiotów rządowych (w stosownych przypadkach).
Stawka podatku MINT_APPROX_TAX_RATE Przybliżona stawka podatku dla dewelopera. Podaj wartość dziesiętną z maksymalnie 3 znakami przed przecinkiem i 4 znakami po przecinku.

Zarządzanie deweloperami za pomocą interfejsu API

Zarządzaj deweloperami za pomocą interfejsów API dla deweloperów.

Podczas tworzenia i aktualizowania dewelopera za pomocą interfejsu API możesz w razie potrzeby skonfigurować atrybuty zarabiania opisane w sekcji Konfigurowanie atrybutów zarabiania.