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:
- Jeśli masz płatne konto Edge, deweloperzy mogą zarejestrować się samodzielnie w portalu dla programistów. Więcej informacji znajdziesz w jednej z tych sekcji w zależności od typu portalu dla programistów:
- Zintegrowany portal: tworzenie konta dewelopera w zintegrowanym portalu
- Drupal 10: rejestrowanie konta dewelopera aplikacji
- Drupal 7: Dodawanie kont użytkowników i zarządzanie nimi
- Administratorzy mogą rejestrować deweloperów aplikacji za pomocą interfejsu API.
- Jako administrator portalu dla programistów możesz zarządzać programistami bezpośrednio w portalu, jak opisano w tych sekcjach:
- Zintegrowany portal: zarządzaj kontami deweloperów.
- Drupal 10: Jak deweloperzy aplikacji wchodzą w interakcje z modułem Apigee Edge
- Drupal 7: Dodawanie kont użytkowników i zarządzanie nimi
- Jako administrator organizacji możesz zarządzać deweloperami za pomocą interfejsu lub interfejsu API Edge zgodnie z opisem w sekcjach poniżej.
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:
- Zaloguj się na apigee.com/edge.
- 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:
- 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. - Na pasku nawigacyjnym po lewej stronie kliknij Opublikuj > Deweloperzy.
Wyświetli się strona Deweloperzy.

Jak widać na ilustracji, strona Deweloperzy umożliwia:
Dodawanie dewelopera
Aby dodać dewelopera:
- Otwórz stronę Deweloperzy.
- Kliknij + Deweloper.
- Wpisz dane dewelopera, w tym imię, nazwisko, adres e-mail i nazwę użytkownika.
- 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:
- Otwórz stronę Deweloperzy.
- Kliknij wiersz dewelopera, którego chcesz wyświetlić i edytować, aby otworzyć jego szczegóły.
- 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
- Nazwa użytkownika
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. - 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:
- Otwórz stronę Deweloperzy.
- Kliknij wiersz dewelopera, w przypadku którego chcesz zarządzać atrybutami niestandardowymi, aby otworzyć szczegóły dewelopera.
- W sekcji Atrybuty niestandardowe kliknij +.
- Wpisz nazwę i wartość atrybutu.
- Kliknij
. - 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:
- Otwórz stronę Deweloperzy.
- Kliknij wiersz dewelopera, którego chcesz aktywować lub dezaktywować, aby otworzyć jego szczegóły.
- W sekcji Szczegóły ustaw w polu Stan wartość Aktywny lub Nieaktywny.
- 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:
- Otwórz stronę Deweloperzy.
- Kliknij Eksportuj plik CSV...
- W menu kliknij Deweloperzy lub Deweloperzy, aplikacje i usługi.
Wybrane dane o publikowaniu zostaną pobrane jako plik CSV.
Usuwanie dewelopera
Aby usunąć dewelopera:
- Otwórz stronę Deweloperzy.
- Umieść kursor na wierszu dewelopera, którego chcesz usunąć, aby wyświetlić menu czynności.
- Kliknij
. - 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:
- Drupal 10: Synchronizowanie programistów z Apigee Edge
- Drupal 7: Synchronizowanie deweloperów aplikacji między portalem a Edge
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:
|
| 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:
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: |
| 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.