Gestisci le categorie di sviluppatori

Stai visualizzando la documentazione di Apigee Edge.
Vai alla sezione Documentazione di Apigee X. Informazioni

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

Esplorazione della pagina Categorie sviluppatori

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

Aggiunta di una categoria sviluppatore

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

1. Accedi alla pagina Sviluppa le 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 una società a una categoria di sviluppatori

Aggiungere una società a una categoria di sviluppatori. Un'azienda 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 dell'azienda.
5. Fai clic su Salva.
   

Modificare una categoria sviluppatore

Per modificare una categoria sviluppatore utilizzando l'interfaccia utente:

1. Accedi alla pagina Sviluppa le categorie.
2. Posiziona il cursore sulla categoria di sviluppatori 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 Sviluppa le categorie.
2. Posiziona il cursore sulla categoria di sviluppatori che vuoi modificare.
3. Fai clic su .
4. Fai clic su Elimina per confermare l'operazione.

Gestione di categorie di sviluppatori tramite l'API

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

Aggiunta di una categoria sviluppatore utilizzando l'API

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

Quando emetti la richiesta, specifichi la categoria 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 avere un aspetto simile a questo:

{
  "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

Aggiungere uno sviluppatore o una società a una categoria di sviluppatori quando aggiungi o modifichi l'azienda oppure sviluppatore rilasciando un POST alle seguenti risorse:

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

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

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

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

Specifica MINT_DEVELOPER_CATEGORY come attributo nel corpo della richiesta con il ID interno della categoria come valore. Ad esempio, la seguente richiesta aggiunge un modello già esistente sviluppatore alla categoria "Oro" , che ha un ID pari a 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 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 in la 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 di 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 dello sviluppatore categoria. 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 sviluppatori 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. Per 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.