Gestisci le categorie di sviluppatori

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

Una categoria di sviluppatori è un raggruppamento di sviluppatori o aziende con caratteristiche simili che ti consente di configurare la monetizzazione per operare in quella categoria specifica. Ad esempio, puoi creare piani tariffari che si applicano a tutti gli sviluppatori che sviluppano app per la condivisione delle entrate creando una categoria di sviluppatori denominata "revenue_sharing" e aggiungendo gli sviluppatori. Per ulteriori informazioni sulla creazione di piani tariffari con categorie di sviluppatori, consulta Creare piani tariffari.

Esplorare la pagina Categorie sviluppatore

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

Aggiunta di una categoria di sviluppatore

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

1. Accedi alla pagina Sviluppa categorie.
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 un'azienda a una categoria di sviluppatori

Aggiungere una società a una categoria di sviluppatori. 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 la società da 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.
   

Modificare una categoria di sviluppatore

Per modificare una categoria di sviluppatore utilizzando l'interfaccia utente:

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

Eliminazione di una categoria di sviluppatore

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

1. Accedi alla pagina Sviluppa categorie.
2. Posiziona il cursore sopra la categoria sviluppatore che vuoi modificare.
3. Fai clic su .
4. Fai clic su Elimina per confermare l'operazione.

Gestione delle categorie di sviluppatori utilizzando l'API

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

Aggiunta di una categoria di sviluppatori tramite l'API

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

Quando invii la richiesta, specifica 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 un'azienda a una categoria di sviluppatori utilizzando l'API

Aggiungi uno sviluppatore o un'azienda a una categoria di sviluppatori quando aggiungi o modifichi l'azienda o lo sviluppatore inviando una richiesta POST alle seguenti risorse, rispettivamente:

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

Per aggiungere uno sviluppatore o un'azienda a una categoria di sviluppatori quando modifichi l'azienda o lo sviluppatore, invia una richiesta PUT alle seguenti risorse, rispettivamente:

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

Un'azienda o uno sviluppatore può 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 richiesta seguente aggiunge uno sviluppatore già esistente alla categoria degli 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

Visualizzazione delle categorie di sviluppatori tramite l'API

Visualizza una categoria di sviluppatori specifica o tutte le categorie di sviluppatori in 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 di sviluppatori (l'ID viene restituito nella risposta quando aggiungi la categoria di sviluppatori). 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

Modificare 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 di sviluppatori:

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 di sviluppatore mediante l'API

Elimina una categoria di sviluppatori 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 sviluppatore per l'API

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

Nome	Descrizione	Predefinito	Obbligatorio?
name	Nome della proprietà. Impostato su MINT_DEVELOPER_CATEGORY.	N/D	Sì
value	ID della categoria dello sviluppatore a cui viene aggiunto lo sviluppatore.	N/D	Sì, per impostare la categoria sviluppatore.