Zarządzanie firmami i deweloperami za pomocą Edge

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

Jeśli chcesz mieć większą kontrolę nad firmami i deweloperami, którzy biorą udział w Twoim programie API z monetyzacją (np. jeśli chcesz utworzyć wewnętrzne firmy i konta deweloperów na potrzeby testowania) możesz utworzyć firmy i konta deweloperów ręcznie za pomocą interfejsu zarządzania i interfejsu API.

Głównym czynnikiem decydującym o tym, czy musisz ręcznie utworzyć firmy i konta deweloperów, jest to, czy deweloperzy będą potrzebować danych logowania, aby zalogować się w interfejsie zarządzania, wysyłać dane logowania w wywołaniach interfejsu Edge Management API lub zalogować się w portalu dla programistów.

• Jeśli deweloperzy korzystający z monetyzacji potrzebują danych logowania, aby uzyskać dostęp do interfejsu Edge lub interfejsu API, muszą najpierw mieć własne konto administratora Apigee.
• Jeśli musisz po prostu utworzyć deweloperów testowych, którzy nie potrzebują danych logowania (np. jeśli chcesz wykonywać wywołania API za pomocą fikcyjnych deweloperów testowych), nie są wymagane żadne konta Apigee.

Zarządzanie deweloperami aplikacji za pomocą interfejsu

Twórz deweloperów aplikacji, zarządzaj nimi i aktywuj ich za pomocą interfejsu Edge zgodnie z opisem w artykule Zarządzanie deweloperami aplikacji. Po utworzeniu deweloperów aplikacji możesz dodać ich do firm zgodnie z opisem w kolejnych sekcjach.

Zarządzanie firmami za pomocą interfejsu

Twórz firmy, zarządzaj nimi i aktywuj je zgodnie z opisem w kolejnych sekcjach.

Poznawanie strony Firmy

Otwórz stronę Firmy w sposób opisany poniżej.

Dodawanie firmy

Aby dodać firmę:

1. Otwórz stronę Firmy.
2. Kliknij + Firma.
3. Wpisz dane firmy.

   Wymagane pola:

   • Nazwa firmy
   • Administrator (użytkownik, który jest głównym administratorem firmy administrator)
   • Typ płatności

   W zależności od konfiguracji rozliczeń zarabiania typ płatności może domyślnie przyjmować wartość PREPAID lub POSTPAID. Więcej informacji znajdziesz w artykule Konfigurowanie typów płatności przedpłaconych i popłaconych za pomocą interfejsu API.

4. Dodaj do firmy co najmniej 1 dewelopera.
   1. W sekcji Deweloperzy wpisz ciąg znaków w polu Dodaj dewelopera, aby wyświetlić listę deweloperów pasujących do tego ciągu.
   2. Wybierz dewelopera z listy.
   3. Powtórz te czynności, aby dodać do firmy kolejnych deweloperów.
5. Dodaj co najmniej 1 atrybut niestandardowy.
   1. W sekcji Atrybuty niestandardowe kliknij + Nowy.
   2. Wpisz nazwę i wartość atrybutu niestandardowego.
   3. Powtórz te czynności, aby dodać do firmy kolejne atrybuty niestandardowe.
6. Kliknij Utwórz firmę.

Aktywowanie i dezaktywowanie firmy

Aby aktywować i dezaktywować firmę:

1. Otwórz stronę Firmy.
2. Najedź kursorem na firmę, którą chcesz aktywować, i w menu czynności włącz .
   Aby dezaktywować firmę, wyłącz przełącznik.

Edytowanie firmy

Aby edytować firmę:

1. Otwórz stronę Firmy.
2. Najedź kursorem na firmę, którą chcesz edytować, i w menu czynności kliknij .
3. W razie potrzeby zaktualizuj dane firmy.
4. Aby zapisać zmiany, kliknij Zaktualizuj firmę.

Usuwanie firmy

Aby usunąć firmę:

1. Otwórz stronę Firmy.
2. Najedź kursorem na firmę, którą chcesz usunąć, i w menu czynności kliknij .
3. Aby potwierdzić usunięcie, kliknij Usuń.

Zarządzanie firmami i deweloperami za pomocą interfejsu API

Zarządzanie firmami i deweloperami za pomocą interfejsu API opisano w kolejnych sekcjach.

Tworzenie i aktualizowanie firm oraz deweloperów za pomocą interfejsu API

Aby zarządzać firmami i deweloperami za pomocą interfejsu Edge Management API, zapoznaj się z tymi sekcjami interfejsu API:

• Tworzenie firmy
• Tworzenie dewelopera
  Uwaga: podczas tworzenia dewelopera skonfiguruj informacje o monetyzacji, przekazując atrybuty niestandardowe.
• Dodawanie lub aktualizowanie deweloperów firmy
  Uwaga: opcjonalnie możesz przypisać deweloperowi rolę, ale nie jest to wymagane. Aby uzyskać listę ról dewelopera, przeczytaj artykuł Pobieranie ról dewelopera.
• Wyświetlanie konfiguracji monetyzacji dla wszystkich deweloperów lub dla jednego dewelopera
  Uwaga: informacje o monetyzacji zdefiniuj, przekazując atrybuty niestandardowe podczas tworzenia lub aktualizowania dewelopera. Możesz wyświetlić atrybuty niestandardowe monetyzacji ustawione za pomocą standardowego interfejsu API (nie związanego z monetyzacją), aby wyświetlić listę wszystkich deweloperów lub jednego dewelopera.

Zarządzanie rolami dewelopera za pomocą interfejsu API

Role możesz tworzyć za pomocą interfejsów API monetyzacji. Umożliwia to ustanawianie ról dla partnerów. Możesz na przykład ustanowić role administratora i dewelopera aplikacji dla a partnera. Te role można następnie przypisać konkretnym pracownikom partnera.

Tworzenie roli dewelopera

Aby utworzyć rolę dewelopera, wyślij żądanie POST do organizations/{org_name}/developer-roles. Podczas wysyłania żądania musisz w treści żądania określić nazwę i opis roli oraz identyfikację organizacji. Na przykład:

$ curl -H "Content-Type:application/json" -X POST -d \
'{
   "name": "appDeveloper",
   "description": "App Developer",
   "organization": {
       "id": "{org_name}"
   }
 }' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developer-roles" \
-u email:password

Pobieranie ról dewelopera

Aby pobrać role dewelopera, wyślij żądanie GET do `organizations/{org_id}/developer-roles`. Na przykład:

$ curl -H "Accept:application/json" -X GET \
"https:// api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developer-roles" \
-u email:password

Odpowiedź powinna wyglądać mniej więcej tak (pokazano tylko część odpowiedzi):

{
  "description" : "App Developer",
  "id" : "appdeveloper",
  "name" : "appDeveloper",
  "organization" : {
   ...
  }
}

Ustawienia konfiguracji ról dewelopera w interfejsie API

W interfejsie API są dostępne te opcje konfiguracji ról dewelopera:

Pobieranie stawki podatku dla dewelopera za pomocą interfejsu API

Aktualną stawkę podatku dla dewelopera możesz uzyskać, wysyłając żądanie GET do organizations/{org_name}/tax-engine. Podczas wysyłania żądania musisz określić identyfikację dewelopera jako parametr zapytania. Na przykład:

$ curl -H "Accept:application/json" -X GET \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/tax-engine?developerId=dev7@myorg.com" \
-u email:password

Odpowiedź powinna wyglądać mniej więcej tak:

0.09

Wykonywanie innych zadań związanych z deweloperem za pomocą interfejsu API

Wiele zadań związanych z monetyzacją, które możesz wykonać w przypadku organizacji, np. tworzenie planów taryfowych lub tworzenie warunków powiadomień, możesz też wykonać w przypadku poszczególnych deweloperów. Możesz na przykład utworzyć konto bankowe dla konkretnego dewelopera lub wygenerować raport Przychody dla konkretnego dewelopera.

W tabeli poniżej znajdziesz listę zadań związanych z deweloperami, które możesz wykonać za pomocą interfejsów API monetyzacji. Tabela zawiera też informacje o tym, gdzie można znaleźć szczegółowe instrukcje wykonywania tych zadań.