Gestisci le categorie di sviluppatori

Stai visualizzando la documentazione di Apigee Edge.
Consulta la 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 in modo che operi su 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 saperne di più sulla creazione di piani tariffari con le categorie di sviluppatori, vedi Creare piani tariffari.

Esplorare la pagina Categorie di sviluppatori

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

Aggiungere una categoria di sviluppatori

Per aggiungere una categoria di sviluppatori utilizzando la UI:

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

Aggiungere un'azienda a una categoria di sviluppatori

Aggiungi un'azienda 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 di sviluppatori.
3. Fai clic su Modifica nella pagina dell'azienda.
4. Seleziona la categoria di sviluppatori per l'azienda.
5. Fai clic su Salva.
   

Modificare una categoria di sviluppatori

Per modificare una categoria di sviluppatori utilizzando la UI:

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

Eliminare una categoria di sviluppatori

Per eliminare una categoria di sviluppatori utilizzando la UI:

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

Gestire le categorie di sviluppatori utilizzando l'API

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

Aggiungere una categoria di sviluppatori utilizzando l'API

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

Quando invii la richiesta, devi specificare sia 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 essere simile alla seguente:

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

Aggiungere uno sviluppatore o 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 POST richiesta 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 PUT richiesta 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 seguente richiesta aggiunge uno sviluppatore già esistente alla categoria di sviluppatori denominata "Gold", 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 di sviluppatori utilizzando 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 in the response when you add the developer category). 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. Nel corpo della richiesta devi specificare le impostazioni aggiornate e l'ID della categoria di sviluppatori. 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

Eliminare una categoria di sviluppatori utilizzando 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 di sviluppatori 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 seguente tabella riassume le proprietà di configurazione che possono essere impostate utilizzando l'API.