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.

Informacje o stronie Kategorie deweloperów

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 dewelopera.
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ę Tworzenie kategorii.
2. Najedź kursorem na kategorię deweloperów, którą chcesz edytować, i kliknij .
3. Wpisz kategorię dewelopera.
4. Kliknij Zaktualizuj kategorię dewelopera.

Usuwanie kategorii deweloperów

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 deweloperów za pomocą interfejsu API

Zarządzaj kategoriami deweloperów za pomocą interfejsu API w sposób opisany w następnych sekcjach.

Dodawanie kategorii dewelopera za pomocą interfejsu API

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

Gdy wysyłasz żądanie, w pliku danych podajesz 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 odpowiednio żą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.

Określ MINT_DEVELOPER_CATEGORY jako atrybut w treści żądania, a jego wartością jest 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. 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 dotyczące 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 usługi. Ustawiono na MINT_DEVELOPER_CATEGORY.	Nie dotyczy	Tak
value	Identyfikator kategorii dewelopera, do której jest dodawany deweloper.	Nie dotyczy	Tak, aby ustawić kategorię dewelopera.