Zarządzaj kategoriami dewelopera

Przeglądasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. Informacje

Kategoria dewelopera to grupa deweloperów lub firm o podobnych cechach, która umożliwia skonfigurowanie zarabiania tak, aby działały w konkretnej kategorii. Możesz na przykład utworzyć plany stawek dla wszystkich deweloperów, którzy tworzą aplikacje umożliwiające dzielenie się przychodami. 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 stawek z kategoriami dla deweloperów znajdziesz w artykule o tworzeniu planów stawek.

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.

Dodawanie kategorii dewelopera

Aby dodać kategorię dewelopera za pomocą interfejsu:

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

Dodawanie firmy do kategorii dewelopera

Dodaj firmę do kategorii dewelopera. Firma może należeć tylko do jednej kategorii deweloperów.

Aby dodać firmę do kategorii dewelopera:

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 dla swojej firmy kategorię programistów.
5. Kliknij Zapisz.
   

Edytowanie kategorii dewelopera

Aby edytować kategorię dewelopera w interfejsie:

1. Otwórz stronę Kategorie programowania.
2. Najedź kursorem na kategorię dewelopera, 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 programowania.
2. Umieść kursor nad kategorią dewelopera, którą chcesz edytować.
3. Kliknij .
4. Kliknij Usuń, aby potwierdzić operację.

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

Kategorie deweloperów możesz zarządzać za pomocą interfejsu API w sposób opisany w sekcjach poniżej.

Dodawanie kategorii programistów za pomocą interfejsu API

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

Wysyłając żądanie, określasz kategorię name 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 dewelopera lub firmy do kategorii dewelopera za pomocą interfejsu API

Dodaj dewelopera lub firmę do kategorii dewelopera podczas dodawania lub edytowania firmy bądź dewelopera, wysyłając żądanie POST odpowiednio do tych zasobów:

• /organizations/{org_name}/companies
• /organizations/{org_name}/developers

Aby dodać dewelopera lub firmę do kategorii dewelopera podczas jej edytowania, wyślij żądanie PUT odpowiednio 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.

Określ MINT_DEVELOPER_CATEGORY jako atrybut w treści żądania, podając wewnętrzny identyfikator kategorii jako wartość. Na przykład to żądanie dodaje istniejącego dewelopera do kategorii dewelopera o nazwie „Złoto”, o identyfikatorze 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 programistów przy użyciu interfejsu API

Wyświetl konkretną kategorię lub wszystkie kategorie deweloperów w organizacji.

Aby wyświetlić konkretną kategorię dewelopera, wyślij żądanie GET do /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

Wyświetl wszystkie kategorie deweloperów interfejsów API w organizacji, wysyłając żądanie GET do /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 programisty za pomocą interfejsu API

Zmień kategorię dewelopera, wysyłając żądanie PUT do /mint/organizations/{org_name}/developer-categories/{category_id}, gdzie {category_id} to kategoria, 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 programistów przy użyciu interfejsu API

Aby usunąć kategorię dewelopera, wyślij do /mint/organizations/{org_name}/developer-categories/{category_id} żądanie usunięcia, gdzie {category_id} to kategoria 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 programisty dla interfejsu API

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

Nazwa	Opis	Domyślne	Wymagana?
name	Nazwa usługi. Ustawiono na MINT_DEVELOPER_CATEGORY.	Nie dotyczy	Tak
value	Identyfikator kategorii dewelopera, do której został dodany deweloper.	Nie dotyczy	Tak. Żeby ustawić kategorię dewelopera.