Wyświetlasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. info
Kategoria deweloperów to grupa deweloperów lub firm o podobnych cechach, która umożliwia skonfigurowanie zarabiania w ramach danej kategorii. Możesz na przykład utworzyć plany cenowe, które będą obowiązywać wszystkich deweloperów tworzących aplikacje z udziałem w przychodach. Aby to zrobić, utwórz kategorię deweloperów o nazwie „revenue_sharing” i dodaj do niej deweloperów. Więcej informacji o tworzeniu planów cenowych z kategoriami programistów znajdziesz w artykule Tworzenie planów cenowych.
Poznawanie strony Kategorie dewelopera
Otwórz stronę Kategorie dla deweloperów, korzystając z interfejsu Edge lub klasycznego interfejsu Edge, jak opisano w następnych sekcjach.
Interfejs Edge
Aby otworzyć stronę Kategorie do opracowania:
- Zaloguj się na stronie apigee.com/edge.
- Na pasku nawigacyjnym po lewej stronie kliknij Opublikuj > Generowanie przychodu > Kategorie deweloperów.
Pojawi się strona Kategorie deweloperów.
Jak widać na rysunku, na stronie Kategorie dla deweloperów możesz:
- Wyświetlanie bieżących kategorii deweloperów
- Dodawanie, edytowanie lub usuwanie kategorii dewelopera
Classic Edge (Private Cloud)
Aby otworzyć stronę Tworzenie kategorii za pomocą klasycznego interfejsu Edge:
- Zaloguj się na stronie
http://ms-ip:9000
, gdzie ms-ip to adres IP lub nazwa DNS węzła serwera zarządzania. - Na pasku nawigacyjnym u góry kliknij Opublikuj > Kategorie deweloperów.
Pojawi się strona Kategorie deweloperów.
Na stronie Kategorie deweloperów możesz:
- Wyświetlanie bieżących kategorii deweloperów
- Dodawanie, edytowanie lub usuwanie kategorii dewelopera
Dodawanie kategorii dewelopera
Aby dodać kategorię dewelopera za pomocą interfejsu:
- Otwórz stronę Kategorie.
- Kliknij + Kategoria dla deweloperów.
- Wpisz nazwę nowej kategorii i jej krótki opis.
- Kliknij Utwórz kategorię dla deweloperów.
Dodawanie firmy do kategorii deweloperów
Dodaj firmę do kategorii deweloperów. Firma może należeć tylko do jednej kategorii deweloperów.
Aby dodać firmę do kategorii deweloperów:
- Na pasku nawigacyjnym u góry kliknij Opublikuj > Firmy.
- Wybierz firmę, którą chcesz dodać do kategorii deweloperów.
- Na stronie firmy kliknij Edytuj.
- Wybierz Kategorię dewelopera firmy.
- Kliknij Zapisz.
Edytowanie kategorii dewelopera
Aby edytować kategorię dewelopera w interfejsie:
- Otwórz stronę Kategorie.
- Najedź kursorem na kategorię deweloperów, którą chcesz edytować, i kliknij
.
- Wpisz kategorię dewelopera.
- Kliknij Zaktualizuj kategorię dewelopera.
Usuwanie kategorii dewelopera
Aby usunąć kategorię dewelopera za pomocą interfejsu:
- Otwórz stronę Kategorie.
- Umieść kursor na kategorii dewelopera, którą chcesz edytować.
- Kliknij
.
- Aby potwierdzić operację, kliknij Usuń.
Zarządzanie kategoriami programistów za pomocą interfejsu API
Zarządzaj kategoriami deweloperów za pomocą interfejsu API w sposób opisany w sekcjach poniżej.
Dodawanie kategorii dewelopera za pomocą interfejsu API
Aby dodać kategorię dewelopera, wyślij żądanie POST do adresu /mint/organizations/{org_name}/developer-categories
.
Gdy wysyłasz żądanie, musisz w danych ładunku podać kategorię name
i description
. Na przykład:
curl -X POST "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developer-categories" \ -H "Content-Type:application/json" \ -d '{ "name": "Gold", "description": "Gold membership" }' \ -u email:password
Odpowiedź powinna wyglądać mniej więcej tak:
{ "description" : "Gold membership", "id" : "aa6f960a-d9fd-416e-be39-c071418aabd0", "name" : "Gold" }
Dodawanie programisty lub firmy do kategorii programistów za pomocą interfejsu API
Dodaj dewelopera lub firmę do kategorii dewelopera, gdy dodajesz lub edytujesz firmę lub dewelopera, wysyłając żądanie POST do tych zasobów:
- /organizations/{org_name}/companies
- /organizations/{org_name}/developers
Aby dodać dewelopera lub firmę do kategorii dewelopera podczas edytowania firmy lub dewelopera, prześlij odpowiednio prośbę PUT do tych zasobów:
- /organizations/{org_name}/companies/{company_id}
- /organizations/{org_name}/developers/{developer_id}
Firma lub deweloper może należeć tylko do jednej kategorii deweloperów.
W treści żądania jako atrybut podaj wartość MINT_DEVELOPER_CATEGORY
, podając wewnętrzny identyfikator kategorii. Na przykład poniższe żądanie dodaje już istniejącego dewelopera do kategorii deweloperów o nazwie „Złoty”, która ma identyfikator aa6f960a-d9fd-416e-be39-c071418aabd0
.
curl -X PUT "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers/K4jW2QLjZ1h8GFA8" \ -H "Content-Type: application/json" \ -d '{ "email" : "developer@apigee.com", "developerId" : "K4jW2QLjZ1h8GFA8", "firstName" : "Dev", "lastName" : "One", "userName" : "devone", "attributes" : [ { "name" : "MINT_REGISTRATION_ID", "value" : "dev1" }, { "name" : "MINT_DEVELOPER_LEGAL_NAME", "value" : "DEV ONE" }, { "name" : "MINT_DEVELOPER_TYPE", "value" : "TRUSTED" }, { "name" : "MINT_BILLING_TYPE", "value" : "PREPAID" }, { "name" : "MINT_IS_BROKER", "value" : "TRUE" }, { "name" : "MINT_DEVELOPER_CATEGORY", "value" : "aa6f960a-d9fd-416e-be39-c071418aabd0" }, { "name" : "MINT_DEVELOPER_ADDRESS", "value" : "{ "address1": "Dev One Address", "city": "Pleasanton", "country": "US", "isPrimary": "true", "state": "CA", "zip": "94588" }" } }' \ -u email:password
Wyświetlanie kategorii deweloperów za pomocą interfejsu API
Wyświetlanie określonej kategorii deweloperów lub wszystkich kategorii deweloperów w organizacji.
Aby wyświetlić konkretną kategorię deweloperów, wyślij żądanie GET do adresu /mint/organizations/{org_name}/developer-categories/{category_id}
, gdzie {category_id}
to identyfikator kategorii deweloperów (identyfikator jest zwracany w odpowiedzi na dodanie kategorii deweloperów). Na przykład:
curl -X GET "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developer-categories/aa6f960a-d9fd-416e-be39-c071418aabd0" \ -H "Accept:application/json" \ -u email:password
Aby wyświetlić wszystkie kategorie interfejsu API dla organizacji, wyślij żądanie GET do adresu /mint/organizations/{org_id}/developer-categories
. Na przykład:
curl -X GET "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developer-categories" \ -H "Accept:application/json" \ -u email:password
Edytowanie kategorii dewelopera za pomocą interfejsu API
Aby edytować kategorię dewelopera, wyślij żądanie PUT do adresu /mint/organizations/{org_name}/developer-categories/{category_id}
, gdzie {category_id}
to identyfikator kategorii, którą chcesz zaktualizować. W treści żądania musisz podać zaktualizowane ustawienia i identyfikator kategorii dewelopera. Na przykład to żądanie zmienia opis kategorii dewelopera:
curl -X PUT "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developer-categories/aa6f960a-d9fd-416e-be39-c071418aabd0" \ -H "Content-Type: application/json" \ -d '{ "id": "aa6f960a-d9fd-416e-be39-c071418aabd0", "description": "Premium membership" }' \ -u email:password
Usuwanie kategorii dewelopera za pomocą interfejsu API
Aby usunąć kategorię dewelopera, wyślij żądanie usunięcia do adresu /mint/organizations/{org_name}/developer-categories/{category_id}
, gdzie {category_id}
to identyfikator kategorii dewelopera, która ma zostać usunięta. Na przykład:
curl -X DELETE "https://api.enterprise.apigee.com /v1/mint/organizations/{org_name}/developer-categories/aa6f960a-d9fd-416e-be39-c071418aabd0" \ -H "Accept:application/json" \ -u email:password
Właściwości konfiguracji kategorii dewelopera dla interfejsu API
W tabeli poniżej podano właściwości konfiguracji, które można ustawić za pomocą interfejsu API.
Nazwa | Opis | Domyślny | Wymagany? |
---|---|---|---|
name |
Nazwa właściwości. Ustaw na MINT_DEVELOPER_CATEGORY. |
Nie dotyczy | Tak |
value |
Identyfikator kategorii dewelopera, do której jest dodawany deweloper. |
Nie dotyczy | Tak, aby ustawić kategorię dewelopera. |