Gestisci le categorie di sviluppatori

Stai visualizzando la documentazione di Apigee Edge.
Vai alla documentazione di Apigee X. informazioni

Una categoria di sviluppatori è un raggruppamento di sviluppatori o società con caratteristiche simili che ti consente di configurare la monetizzazione in modo da operare su quella categoria specifica. Ad esempio, puoi creare piani tariffari applicabili a tutti gli sviluppatori che sviluppano app per la condivisione delle entrate creando una categoria sviluppatore chiamata "revenue_sharing" e aggiungendo sviluppatori. Per saperne di più sulla creazione di piani tariffari con le categorie di sviluppatori, consulta Creare piani tariffari.

Esplorazione della pagina Categorie sviluppatori

Accedi alla pagina Categorie sviluppatori utilizzando l'interfaccia utente Edge o la UI classica di Edge, come descritto nelle sezioni seguenti.

Aggiunta di una categoria sviluppatore

Per aggiungere una categoria sviluppatore utilizzando l'interfaccia utente:

1. Accedi alla pagina Categorie di sviluppo.
2. Fai clic su + Categoria sviluppatore.
3. Inserisci un nome per la nuova categoria e una breve descrizione.
4. Fai clic su Crea categoria sviluppatore.

Aggiunta di una società a una categoria sviluppatore

Aggiungi una società a una categoria sviluppatore. Una società può appartenere a una sola categoria di sviluppatori.

Per aggiungere un'azienda a una categoria di sviluppatori:

1. Seleziona Pubblica > Aziende nella barra di navigazione in alto.
2. Seleziona l'azienda che vuoi aggiungere alla categoria sviluppatore.
3. Fai clic su Modifica nella pagina dell'azienda.
4. Seleziona la Categoria sviluppatore per l'azienda.
5. Fai clic su Salva.
   

Modifica di una categoria sviluppatore

Per modificare una categoria sviluppatore utilizzando l'interfaccia utente:

1. Accedi alla pagina Categorie di sviluppo.
2. Posiziona il cursore sulla categoria sviluppatore che vuoi modificare e fai clic su .
3. Inserisci la categoria sviluppatore.
4. Fai clic su Aggiorna categoria sviluppatore.

Eliminazione di una categoria sviluppatore

Per eliminare una categoria di sviluppatori utilizzando l'interfaccia utente:

1. Accedi alla pagina Categorie di sviluppo.
2. Posiziona il cursore sulla categoria sviluppatore che vuoi modificare.
3. Fai clic su .
4. Fai clic su Elimina per confermare l'operazione.

Gestione delle categorie di sviluppatori tramite l'API

Gestisci le categorie sviluppatori utilizzando l'API, come descritto nelle sezioni seguenti.

Aggiunta di una categoria sviluppatore utilizzando l'API

Aggiungi una categoria sviluppatore inviando una richiesta POST a /mint/organizations/{org_name}/developer-categories.

Quando invii la richiesta, specifichi le categorie name e description nel payload. Ad esempio:

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

La risposta dovrebbe essere simile alla seguente:

{
  "description" : "Gold membership",
  "id" : "aa6f960a-d9fd-416e-be39-c071418aabd0",
  "name" : "Gold"
}

Aggiunta di uno sviluppatore o di una società a una categoria di sviluppatori utilizzando l'API

Aggiungi uno sviluppatore o una società a una categoria sviluppatore quando aggiungi o modifichi la società o lo sviluppatore inviando una richiesta POST rispettivamente alle seguenti risorse:

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

Per aggiungere uno sviluppatore o una società a una categoria sviluppatore quando modifichi la società o lo sviluppatore, invia una richiesta PUT alle seguenti risorse, rispettivamente:

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

Una società o uno sviluppatore possono appartenere a una sola categoria di sviluppatori.

Specifica MINT_DEVELOPER_CATEGORY come attributo nel corpo della richiesta con l'ID interno della categoria come valore. Ad esempio, la seguente richiesta aggiunge uno sviluppatore già esistente alla categoria di sviluppatori denominata "Oro", che ha un ID 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

Visualizzare le categorie sviluppatori utilizzando l'API

Visualizza una categoria di sviluppatori specifica o tutte le categorie di sviluppatori di un'organizzazione.

Visualizza una categoria di sviluppatori specifica inviando una richiesta GET a /mint/organizations/{org_name}/developer-categories/{category_id}, dove {category_id} è l'identificazione della categoria sviluppatore (l'ID viene restituito nella risposta quando aggiungi la categoria sviluppatore). Ad esempio:

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

Visualizza tutte le categorie di sviluppatori API per un'organizzazione inviando una richiesta GET a /mint/organizations/{org_id}/developer-categories. Ad esempio:

curl -X GET "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developer-categories" \
  -H "Accept:application/json" \
  -u email:password

Modifica di una categoria di sviluppatori utilizzando l'API

Modifica una categoria di sviluppatori inviando una richiesta PUT a /mint/organizations/{org_name}/developer-categories/{category_id}, dove {category_id} è l'identificazione della categoria da aggiornare. Devi specificare nel corpo della richiesta le impostazioni aggiornate e l'ID della categoria sviluppatore. Ad esempio, la seguente richiesta modifica la descrizione di una categoria sviluppatore:

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

Eliminazione di una categoria sviluppatore utilizzando l'API

Elimina una categoria sviluppatore inviando una richiesta DELETE a /mint/organizations/{org_name}/developer-categories/{category_id}, dove {category_id} è l'identificazione della categoria sviluppatore da eliminare. Ad esempio:

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

Proprietà di configurazione della categoria di sviluppatori per l'API

La tabella seguente riassume le proprietà di configurazione che possono essere impostate utilizzando l'API.

Nome	Descrizione	Predefinito	Campo obbligatorio?
name	Nome proprietà. Impostato su MINT_SVILUPPO_CATEGORY.	N/A	Sì
value	ID della categoria a cui lo sviluppatore viene aggiunto.	N/A	Sì, per impostare la categoria sviluppatore.