Zarejestruj deweloperów aplikacji

Przeglądasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. Informacje

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

Wstęp

Edge zapewnia wiele korzyści, które całkowicie zależą od tego, kto wywołuje Twoje interfejsy API. Na przykład od informacji o tym, kto dzwoni, zależy na przykład bezpieczeństwo interfejsu API, zarządzanie ruchem i duża ilość danych analitycznych. Skąd Edge wie, kto wywołuje Twoje interfejsy API? Przez odczytanie unikalnych informacji w każdym wywołaniu interfejsu API, np. identyfikatora użytkownika, klucza interfejsu API lub tokena OAuth. Te unikalne informacje blokują lub odblokowują funkcje wbudowane w serwery proxy interfejsów API, dając Ci pełną kontrolę nad dostępem do interfejsów API i ich zachowaniem.

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 uwierzytelniające (klucze klienta i tajne) potrzebne do uzyskania dostępu do interfejsów API.

Jak zarejestrować deweloperów aplikacji

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

Rekomendacje dotyczące zarządzania kontami deweloperów w portalach dla deweloperów

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

W przypadku korzystania ze zintegrowanego portalu to jedyny sposób, aby konta programistów w zintegrowanym portalu i w Edge były zsynchronizowane.

Jeśli korzystasz z portalu dla deweloperów opartego na technologii Drupal, zarządzanie kontami deweloperów bezpośrednio w tym portalu przynosi te korzyści:

  • Gdy dodasz dewelopera przy użyciu interfejsu administratora w portalu, możesz ustawić jego hasło do portalu i aktywować automatycznego e-maila wysyłanego do dewelopera.

    Gdy dodajesz lub zmieniasz programistę w Edge, deweloper nie otrzymuje żadnego e-maila i nie można ustawić jego hasła w portalu. Dlatego deweloper musi zresetować swoje hasło w portalu, aby 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 opartych na technologii Drupal za pomocą Edge, musisz zsynchronizować deweloperów aplikacji między portalem a Edge.

Informacje o stronie dla deweloperów

Uzyskaj dostęp do strony dla deweloperów i przeglądaj ją za pomocą interfejsu Edge i klasycznego interfejsu Edge.

Edge

Aby uzyskać dostęp do strony programistów przy użyciu interfejsu Edge:

  1. Zaloguj się na stronie apigee.com/edge.
  2. Na pasku nawigacyjnym po lewej stronie wybierz Opublikuj > Programiści.

Wyświetli się strona Programiści.

Jak zaznaczyliśmy na ilustracji, na stronie Programiści możesz:

Klasyczna wersja Edge (Private Cloud)

Aby uzyskać dostęp do strony Programiści przy użyciu klasycznego interfejsu użytkownika Edge:

  1. Zaloguj się w 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 wybierz Opublikuj > Programiści.

Wyświetli się strona Programiści.

Dodawanie dewelopera

Aby dodać dewelopera:

  1. Otwórz stronę dla deweloperów.
  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 informacji o deweloperze

Wyświetl i edytuj informacje o deweloperze. W organizacjach, w których włączono zarabianie, możesz edytować niestandardowe atrybuty zarabiania zdefiniowane w artykule Konfigurowanie atrybutów zarabiania.

Aby wyświetlić i edytować informacje o deweloperze:

  1. Otwórz stronę dla deweloperów.
  2. Kliknij wiersz dewelopera, którego chcesz wyświetlić i edytować, aby otworzyć informacje o deweloperze.
  3. W sekcji Szczegóły wyświetlane są następujące informacje. Zmodyfikuj dane dewelopera zgodnie z potrzebami.
    Szczegóły Opis
    Szczegóły imię i nazwisko, nazwę użytkownika i adres e-mail dewelopera, stan i czas trwania rejestracji oraz identyfikator dewelopera;
    Aby edytować dane dewelopera, kliknij dowolne z tych pól:
    • Imię
    • Nazwisko
    • Wyślij e-mailem
    • 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:
    Aplikacje aplikacje zarejestrowane przez dewelopera; Zobacz Rejestrowanie aplikacji.
  4. W polu Stan możesz aktywować lub dezaktywować dewelopera.
    Więcej informacji znajdziesz w artykule Aktywowanie i dezaktywowanie dewelopera.

W przypadku Apigee Edge dla chmury publicznej Edge przechowuje następujące encje w pamięci podręcznej przez co najmniej 180 sekund po uzyskaniu dostępu do encji.

  • tokeny dostępu OAuth. Oznacza to, że unieważniony token może nadal działać przez maksymalnie 3 minuty, aż do wygaśnięcia limitu pamięci podręcznej.
  • Jednostki usługi zarządzania kluczami (KMS) (aplikacje, deweloperzy, produkty API).
  • Atrybuty niestandardowe tokenów OAuth i encji KMS.

Zarządzanie atrybutami niestandardowymi w przypadku dewelopera

Dodaj do 18 atrybutów niestandardowych dla każdego dewelopera, w tym atrybutów zarabiania opisanych w artykule Konfigurowanie atrybutów zarabiania.

Aby zarządzać atrybutami niestandardowymi:

  1. Otwórz stronę dla deweloperów.
  2. Kliknij wiersz dewelopera, którego atrybutami niestandardowymi chcesz zarządzać, aby otworzyć informacje o deweloperze.
  3. W sekcji Atrybuty niestandardowe kliknij +.
  4. Wpisz nazwę i wartość atrybutu.
  5. Kliknij .
  6. Aby usunąć atrybut niestandardowy, najedź na niego kursorem myszy i kliknij w menu czynności.

Aktywowanie i dezaktywowanie dewelopera

Gdy deweloper aplikacji samodzielnie zarejestruje się w portalu, możesz określić, czy jest on domyślnie aktywny.

Gdy deweloper jest nieaktywny, nadal może logować się w portalu dla programistów i tworzyć aplikacje, ale żaden z powiązanych kluczy interfejsu API nie będzie działać. W przypadku braku aktywności dewelopera aplikacje dewelopera, podobnie jak klucze interfejsu API, zachowują swój stan zatwierdzenia (lub inny).

Aby aktywować lub dezaktywować dewelopera:

  1. Otwórz stronę dla deweloperów.
  2. Kliknij wiersz dewelopera, którego chcesz aktywować lub dezaktywować, aby wyświetlić informacje o deweloperze.
  3. W sekcji Szczegóły ustaw pole Stan na Aktywne lub Nieaktywne.
  4. Powtórz te czynności, jeśli deweloper jest w kilku organizacjach.

Eksportowanie danych publikacji

Wyeksportuj te dane publikacji do pliku z wartościami rozdzielanymi przecinkami (CSV):

  • Dane programisty
  • Szczegóły dotyczące dewelopera, aplikacji i interfejsu API

Aby wyeksportować dane publikacji:

  1. Otwórz stronę dla deweloperów.
  2. Kliknij Eksportuj CSV...
  3. W menu wybierz Programiści lub Deweloperzy, aplikacje i usługi.

Wybrane dane publikacji zostaną pobrane w pliku CSV.

Usuwanie dewelopera

Aby usunąć dewelopera:

  1. Otwórz stronę dla deweloperów.
  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 programistów aplikacji między portalem a Edge

Jeśli do publikowania interfejsów API używasz portalu dla programistów opartego na Drupal, zmiany wprowadzone w deweloperach aplikacji za pomocą Edge nie będą w nim przekazywane. Aby te zmiany pojawiły się w portalu, musisz zalogować się w portalu jako administrator i zsynchronizować go z Edge.

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

Grupowanie programistów w firmy

W przypadku zarabiania firma to zbiór deweloperów zarządzanych jako jeden podmiot. Firma może obejmować dowolną grupę odpowiednią dla organizacji, taką jak jednostka biznesowa, linia produktów czy dział. Grupowanie deweloperów w firmy jest przydatne, gdy chcesz powiązać wielu deweloperów w ramach jednej firmy. Może być na przykład konieczne skonfigurowanie różnych firm do celów rozliczeniowych. Deweloperzy w Twojej organizacji nie muszą jednak być powiązani z firmą. Pamiętaj, że deweloper jest zawsze jednym obiektem jednoznacznie identyfikowanym przez element adresu e-mail. Jeśli deweloper jest częścią firmy, zobaczysz nazwę firmy na stronie Programiści.

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 albo podczas tworzenia lub edytowania dewelopera za pomocą API możesz skonfigurować właściwości zarabiania zdefiniowane w tabeli poniżej. Początkowo możesz skonfigurować właściwości zarabiania dla organizacji podczas edytowania profilu organizacji.

Nazwa pola Nazwa atrybutu niestandardowego Opis
Adres MINT_DEVELOPER_ADDRESS

Adres dewelopera, w tym 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 to m.in.:

  • PRORATED: płatności są naliczane na podstawie liczby dni, przez które usługa API jest używana w miesiącu kalendarzowym.
  • CALENDAR_MONTH: płatności są naliczane co miesiąc.
Typ płatności MINT_BILLING_TYPE

Model płatności używany przez dewelopera do rozliczeń. Możliwe wartości:

  • PRZEDPŁATA: deweloper płaci z góry za korzystanie z usługi API. Gdy użytkownik korzysta z interfejsu API, środki są odliczane od salda dewelopera. Deweloper musi utrzymywać saldo z przedpłaty wystarczające do zakupu produktu API.
  • POSTPAID: deweloper jest rozliczany co miesiąc (na fakturze) za korzystanie z usług API. Deweloper płaci za korzystanie z usług API zgodnie z warunkami płatności określonymi w abonamentach uwzględnionych na fakturze.
  • BOTH (Jedno i drugie): obsługuje oba typy płatności. Domyślna wartość to PREPAID.

Zapoznaj się z artykułem Konfigurowanie metod płatności przedpłaconych i opłacanych z góry przy użyciu 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 o zarządzaniu kategoriami deweloperów.
Identyfikator firmy MINT_COMPANY_ID Identyfikator firmy (w stosownych 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
Jest brokerem MINT_IS_BROKER Flaga określająca, czy przychody są wyliczane na podstawie netto.
nazwa Twojej firmy, 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 należy do firmy i chce zasubskrybować opublikowany abonament.
Samodzielne rozliczenia MINT_HAS_SELF_BILLING Flaga określająca, czy faktury za samodzielne rozliczenia są włączone. Jeśli ta opcja jest włączona (true), zamiast zestawienia przychodów generujemy fakturę do samodzielnego rozliczenia. Faktura samoobsługowa to dokument finansowy, który zawiera szczegóły kwoty należnej deweloperowi. Działa jako faktura dla dostawcy interfejsu API w imieniu programisty.
Nr autoryzacji zwolnienia z podatku MINT_TAX_EXEMPT_AUTH_NO Numer zwolnienia z podatku przez organ państwowy (w stosownych przypadkach).
Stawka podatku MINT_APPROX_TAX_RATE Przybliżona stawka podatku dla dewelopera. Podaj wartość dziesiętną o maksymalnej długości 3 znaków przed liczbą dziesiętną i 4 znaków po niej.

Zarządzanie programistami przy użyciu interfejsu API

Zarządzaj programistami za pomocą interfejsów API dla programistów.

Gdy tworzysz i aktualizujesz dewelopera za pomocą interfejsu API, możesz w razie potrzeby skonfigurować atrybuty zarabiania opisane w sekcji Konfigurowanie atrybutów zarabiania.