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 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.

Dodawanie kategorii dewelopera

Aby dodać kategorię dewelopera za pomocą interfejsu:

1. Otwórz stronę Kategorie.
2. Kliknij + Kategoria dla deweloperów.
3. Wpisz nazwę nowej kategorii i jej krótki opis.
4. 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:

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 firmy.
5. Kliknij Zapisz.
   

Edytowanie kategorii dewelopera

Aby edytować kategorię dewelopera w interfejsie:

1. Otwórz stronę Kategorie.
2. Najedź kursorem na kategorię deweloperów, którą chcesz edytować, i kliknij .
3. Wpisz kategorię dewelopera.
4. Kliknij Zaktualizuj kategorię dewelopera.

Usuwanie kategorii dewelopera

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

1. Otwórz stronę Kategorie.
2. Umieść kursor na kategorii dewelopera, którą chcesz edytować.
3. Kliknij .
4. 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.