Zarejestruj deweloperów aplikacji

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

Zarejestruj deweloperów aplikacji i zarządzaj nimi 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, czy wiadomo, kto wywołuje interfejsy API. Na przykład bezpieczeństwo interfejsu API, zarządzanie ruchem i spora ilość danych analitycznych zależą od tego, kto wywołuje interfejsy API. Skąd Edge wie, kto wywołuje interfejsy API? Odczytuje 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 pełną kontrolę nad dostępem do interfejsu API i jego działaniem.

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

Jak zarejestrować deweloperów aplikacji

Deweloperów aplikacji możesz zarejestrować za pomocą jednej z tych metod:

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

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

Jeśli używasz zintegrowanego portalu, jest to jedyny sposób na zapewnienie synchronizacji kont deweloperów w zintegrowanym portalu i Edge.

Jeśli używasz portalu dla programistów opartego na Drupalu, zarządzanie kontami deweloperów bezpośrednio w portalu dla programistów ma te zalety:

  • Gdy dodajesz dewelopera za pomocą interfejsu administratora w portalu, możesz ustawić hasło dewelopera do portalu i wysłać do niego automatyczną wiadomość e-mail.

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

  • Wszystkie 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 za pomocą interfejsu Edge i klasycznego interfejsu Edge.

Edge

Aby otworzyć stronę Deweloperzy za pomocą interfejsu Edge:

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

Wyświetli się strona Deweloperzy.

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

Klasyczny Edge (Private Cloud)

Aby otworzyć stronę Deweloperzy za pomocą klasycznego interfejsu Edge:

  1. Zaloguj się na http://ms-ip:9000, gdzie ms-ip to adres IP lub nazwa DNS węzła serwera zarządzania.
  2. Na pasku nawigacyjnym u góry kliknij Publikuj > Deweloperzy.

Wyświetli się strona Deweloperzy.

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świetlaj i edytuj szczegóły dewelopera. W przypadku organizacji, w których włączono zarabianie, możesz edytować atrybuty niestandardowe zarabiania zdefiniowane w sekcji Konfigurowanie atrybutów zarabiania.

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

  1. Otwórz stronę Deweloperzy.
  2. Kliknij wiersz dewelopera, którego szczegóły chcesz wyświetlić i edytować, aby otworzyć szczegóły dewelopera.
  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ć szczegóły dewelopera, kliknij dowolne z tych pól:
    • Imię
    • Nazwisko
    • E-mail
    • Nazwa użytkownika
    Zmień 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 Apigee Edge for Public Cloud Edge przechowuje w pamięci podręcznej te encje przez co najmniej 180 sekund po uzyskaniu do nich dostępu.

  • Tokeny dostępu OAuth. Oznacza to, że odwołany token może nadal działać przez maksymalnie 3 minuty, do czasu wygaśnięcia limitu pamięci podręcznej.
  • Encje Key Management Service (KMS) (aplikacje, deweloperzy, usługi API).
  • Atrybuty niestandardowe w tokenach OAuth i encjach KMS.

Zarządzanie atrybutami niestandardowymi dewelopera

Do każdego dewelopera możesz dodać maksymalnie 18 atrybutów niestandardowych, w tym atrybuty zarabiania opisane w sekcji Konfigurowanie atrybutów zarabiania.

Aby zarządzać atrybutami niestandardowymi:

  1. Otwórz stronę Deweloperzy.
  2. Kliknij wiersz dewelopera, którego atrybutami niestandardowymi chcesz zarządzać, aby otworzyć szczegóły dewelopera.
  3. W sekcji Atrybuty niestandardowe kliknij +.
  4. Wpisz nazwę i wartość atrybutu.
  5. Kliknij .
  6. Aby usunąć atrybut niestandardowy, najedź na niego kursorem 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ę do portalu dla programistów i tworzyć aplikacje, ale żaden z powiązanych kluczy interfejsu API nie będzie działać. Aplikacje dewelopera nadal mają stan zatwierdzony (lub inny) podobnie jak klucze interfejsu API, mimo że są one nieważ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ć szczegóły dewelopera.
  3. W sekcji Szczegóły ustaw w razie potrzeby pole Stan na Aktywny lub Nieaktywny.
  4. Powtórz te czynności, jeśli deweloper jest w kilku organizacjach.

Eksportowanie danych publikowania

Wyeksportuj te dane publikowania jako plik CSV (wartości rozdzielone przecinkami):

  • szczegóły dewelopera;
  • szczegóły dewelopera, aplikacji i usługi API.

Aby wyeksportować dane publikowania:

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

Wybrane dane publikowania zostaną pobrane w pliku CSV.

Usuwanie dewelopera

Aby usunąć dewelopera:

  1. Otwórz stronę Deweloperzy.
  2. Najedź kursorem na wiersz 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 deweloperach aplikacji za pomocą Edge nie są propagowane do portalu. Aby te zmiany pojawiły się w portalu, musisz zalogować się w nim jako administrator i zsynchronizować portal 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 zarabiania firma to zbiór deweloperów zarządzanych jako pojedyncza jednostka. 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 musisz powiązać kilku deweloperów z jedną firmą. Może być na przykład konieczne skonfigurowanie różnych firm na potrzeby rozliczeń. Deweloperzy w Twojej organizacji nie muszą jednak być powiązani z firmą. Pamiętaj, że deweloper jest zawsze pojedynczą jednostką, jednoznacznie identyfikowaną przez element e-mail. Jeśli deweloper należy do firmy, na stronie Deweloperzy zobaczysz nazwę firmy.

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

Konfigurowanie atrybutów zarabiania

Podczas edytowania dewelopera za pomocą interfejsu UI 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 konfigurujesz właściwości zarabiania dla organizacji podczas edycji profilu organizacji.

Nazwa pola Nazwa atrybutu niestandardowego Opis
Adres MINT_DEVELOPER_ADDRESS

Adres dewelopera, w tym te pola: Adres (wiersze 1 i 2), Miasto, Województwo, Kod pocztowy i Kraj.
Profil płatności MINT_BILLING_PROFILE

Cykl rozliczeniowy Twojej organizacji. Prawidłowe wartości:

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

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

  • PREPAID: deweloper płaci z góry za korzystanie z usługi API. Środki są odejmowane z salda dewelopera, gdy usługa API jest używana. Deweloper musi mieć wystarczające saldo z przedpłaty, aby kupić usługę API.
  • POSTPAID: deweloper otrzymuje co miesiąc fakturę za korzystanie z usług API produktów. 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 płatności. Domyślna wartość to PREPAID.

Więcej informacji znajdziesz w artykule Konfigurowanie typów płatności przedpłaconych i po wykonaniu usługi za pomocą interfejsu API.

Kategoria MINT_DEVELOPER_CATEGORY Kategoria dewelopera, do której chcesz dodać dewelopera. Kategoria dewelopera 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 (jeśli dotyczy). Więcej informacji znajdziesz w artykule Grupowanie deweloperów w firmy.
Typ dewelopera MINT_DEVELOPER_TYPE Ta właściwość nie jest używana przez Apigee.

Typ dewelopera. Prawidłowe wartości: TRUSTED lub UNTRUSTED
Pośrednik MINT_IS_BROKER Flaga określająca, czy przychody są oparte na wartości netto.
Imię i nazwisko MINT_DEVELOPER_LEGAL_NAME Imię i nazwisko dewelopera, które będzie używane we wszystkich raportach.
Uwaga: ten atrybut jest wymagany, jeśli deweloper nie jest zgrupowany w firmie i chce zasubskrybować opublikowany plan taryfowy.
Samofakturowanie MINT_HAS_SELF_BILLING Flaga określająca, czy faktury samofakturowania są włączone. Jeśli ta opcja jest włączona (true), usługa zarabiania generuje fakturę samofakturowania zamiast wyciągu z podziału przychodów. Faktura samofakturowania to dokument finansowy, który zawiera szczegółowe informacje o kwocie należnej do dewelopera. Działa ona jako faktura dla dostawcy interfejsu API w imieniu dewelopera.
Numer zwolnienia z podatku MINT_TAX_EXEMPT_AUTH_NO Numer zwolnienia z podatku (jeśli dotyczy).
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 Developer API.

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