Zarządzaj kategoriami dewelopera

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 tej konkretnej kategorii. Możesz na przykład utworzyć plany stawek, które będą obowiązywać wszystkich deweloperów tworzących aplikacje do podziału przychodów, tworząc kategorię deweloperów o nazwie „revenue_sharing” i dodając do niej deweloperów. Więcej informacji o tworzeniu planów cenowych z kategoriami deweloperów znajdziesz w artykule Tworzenie planów cenowych.

Przeglądanie strony Kategorie deweloperów

Otwórz stronę Kategorie deweloperów w interfejsie Edge lub klasycznym interfejsie Edge zgodnie z opisem w kolejnych sekcjach.

Interfejs Edge

Aby otworzyć stronę Rozwijaj kategorie:

  1. Zaloguj się na stronie apigee.com/edge.
  2. Na pasku nawigacyjnym po lewej stronie wybierz Opublikuj > Generowanie przychodu > Kategorie deweloperów.

Wyświetli się strona Kategorie deweloperów.

Jak widać na ilustracji, na stronie Kategorie deweloperów możesz:

Classic Edge (Private Cloud)

Aby otworzyć stronę Tworzenie kategorii w klasycznym interfejsie Edge:

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

Wyświetli się strona Kategorie deweloperów.

Na stronie Kategorie deweloperów możesz:

Dodawanie kategorii dewelopera

Aby dodać kategorię dewelopera w interfejsie:

  1. Otwórz stronę Tworzenie kategorii.
  2. Kliknij + Kategoria dewelopera.
  3. Wpisz nazwę nowej kategorii i krótki opis.
  4. Kliknij Utwórz kategorię dewelopera.

Dodawanie firmy do kategorii deweloperów

Dodawanie firmy do kategorii deweloperów. Firma może należeć tylko do jednej kategorii deweloperów.

Aby dodać firmę do kategorii deweloperów:

  1. Na pasku nawigacyjnym u góry kliknij Opublikuj > Firmy.
  2. Wybierz firmę, którą chcesz dodać do kategorii deweloperów.
  3. Na stronie firmy kliknij Edytuj.
  4. Wybierz kategorię dewelopera dla firmy.
  5. Kliknij Zapisz.

Edytowanie kategorii dewelopera

Aby edytować kategorię dewelopera w interfejsie:

  1. Otwórz stronę Tworzenie kategorii.
  2. Najedź kursorem na kategorię dewelopera, którą chcesz edytować, i kliknij .
  3. Wpisz kategorię dewelopera.
  4. Kliknij Update Developer Category (Zaktualizuj kategorię dewelopera).

Usuwanie kategorii dewelopera

Aby usunąć kategorię dewelopera za pomocą interfejsu:

  1. Otwórz stronę Tworzenie kategorii.
  2. Umieść kursor na kategorii dewelopera, którą chcesz edytować.
  3. Kliknij .
  4. Kliknij Usuń, aby potwierdzić operację.

Zarządzanie kategoriami deweloperów za pomocą interfejsu API

Zarządzaj kategoriami deweloperów za pomocą interfejsu API zgodnie z opisem w sekcjach poniżej.

Dodawanie kategorii dewelopera za pomocą interfejsu API

Dodaj kategorię dewelopera, wysyłając żądanie POST do adresu /mint/organizations/{org_name}/developer-categories.

W żądaniu musisz podać zarówno kategorię name, jak i description w ładunku. 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 deweloperów, dodając lub edytując 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 deweloperów podczas edytowania firmy lub dewelopera, wyślij żądanie PUT do odpowiednich 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.

Określ MINT_DEVELOPER_CATEGORY jako atrybut w treści żądania, a jako wartość podaj wewnętrzny identyfikator kategorii. Na przykład poniższa prośba dodaje do kategorii deweloperów o nazwie „Złota” (o identyfikatorze aa6f960a-d9fd-416e-be39-c071418aabd0) dewelopera, który już istnieje.

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świetl konkretną kategorię deweloperów lub wszystkie kategorie deweloperów w organizacji.

Aby wyświetlić konkretną kategorię dewelopera, wyślij żądanie GET do adresu /mint/organizations/{org_name}/developer-categories/{category_id}, gdzie {category_id} to identyfikator kategorii dewelopera (identyfikator jest zwracany w odpowiedzi po dodaniu kategorii dewelopera). 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 programistów interfejsu API w 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 na adres /mint/organizations/{org_name}/developer-categories/{category_id}, gdzie {category_id} to identyfikator kategorii do zaktualizowania. W treści żądania musisz podać zaktualizowane ustawienia i identyfikator kategorii dewelopera. Na przykład to żądanie powoduje zmianę opisu 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 DELETE na adres /mint/organizations/{org_name}/developer-categories/{category_id}, gdzie {category_id} to identyfikator kategorii dewelopera, która ma zostać usunięta. Obejmuje to 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 deweloperów w interfejsie API

W tabeli poniżej znajdziesz podsumowanie właściwości konfiguracji, które można ustawić za pomocą interfejsu API.

Nazwa Opis Domyślny Wymagany?
name

Nazwa usługi. Ustaw wartość MINT_DEVELOPER_CATEGORY.

Nie dotyczy Tak
value

Identyfikator kategorii deweloperów, do której należy deweloper.

Nie dotyczy Tak, aby ustawić kategorię dewelopera.