Gerenciar categorias de desenvolvedores

Você está visualizando a documentação do Apigee Edge.
Acesse a documentação da Apigee X. info

Uma categoria de desenvolvedor é um agrupamento de desenvolvedores ou empresas com características semelhantes que permite configurar a monetização para operar nessa categoria específica. Por exemplo, você pode criar planos de taxas que se aplicam a todos os desenvolvedores que desenvolvem apps para compartilhamento de receita. Para isso, crie uma categoria de desenvolvedor chamada "revenue_sharing" e adicione desenvolvedores a ela. Para mais informações sobre a criação de planos de preços com categorias de desenvolvedor, consulte Criar planos de preços.

Como explorar a página "Categorias de desenvolvedores"

Acesse a página "Categorias de desenvolvedor" usando a interface do Edge ou a interface clássica do Edge, conforme descrito nas seções a seguir.

Como adicionar uma categoria de desenvolvedor

Para adicionar uma categoria de desenvolvedor usando a interface:

1. Acesse a página Desenvolver categorias.
2. Clique em + Categoria do desenvolvedor.
3. Digite um nome e uma breve descrição para a nova categoria.
4. Clique em Criar categoria de desenvolvedor.

Como adicionar uma empresa a uma categoria de desenvolvedor

Adicione uma empresa a uma categoria de desenvolvedor. Uma empresa pode pertencer a apenas uma categoria de desenvolvedor.

Para adicionar uma empresa a uma categoria de desenvolvedor:

1. Selecione Publicar > Empresas na barra de navegação na parte de cima.
2. Selecione a empresa que você quer adicionar à categoria de desenvolvedor.
3. Clique em Editar na página da empresa.
4. Selecione a Categoria do desenvolvedor da empresa.
5. Clique em Salvar.
   

Como editar uma categoria de desenvolvedor

Para editar uma categoria de desenvolvedor usando a interface:

1. Acesse a página Categorias de desenvolvimento.
2. Posicione o cursor sobre a categoria de desenvolvedor que você quer editar e clique em .
3. Insira a categoria do desenvolvedor.
4. Clique em Atualizar categoria de desenvolvedor.

Como excluir uma categoria de desenvolvedor

Para excluir uma categoria de desenvolvedor usando a interface:

1. Acesse a página Categorias de desenvolvimento.
2. Posicione o cursor sobre a categoria de desenvolvedor que você quer editar.
3. Clique em .
4. Clique em Excluir para confirmar a operação.

Como gerenciar categorias de desenvolvedores usando a API

Gerencie as categorias de desenvolvedores usando a API, conforme descrito nas seções a seguir.

Como adicionar uma categoria de desenvolvedor usando a API

Adicione uma categoria de desenvolvedor emitindo uma solicitação POST para /mint/organizations/{org_name}/developer-categories.

Ao emitir a solicitação, especifique a categoria name e description no payload. Exemplo:

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

A resposta deverá ser parecida com esta:

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

Adicionar um desenvolvedor ou uma empresa a uma categoria de desenvolvedor usando a API

Adicione um desenvolvedor ou uma empresa a uma categoria de desenvolvedor ao adicionar ou editar a empresa ou o desenvolvedor emitindo uma solicitação POST para os seguintes recursos, respectivamente:

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

Para adicionar um desenvolvedor ou uma empresa a uma categoria de desenvolvedor ao editar a empresa ou o desenvolvedor, emita uma solicitação PUT para os seguintes recursos, respectivamente:

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

Uma empresa ou desenvolvedor pode pertencer a apenas uma categoria.

Especifique o MINT_DEVELOPER_CATEGORY como um atributo no corpo da solicitação com o ID interno da categoria como valor. Por exemplo, a solicitação a seguir adiciona um desenvolvedor já existente à categoria de desenvolvedor "Gold", que tem um ID de 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

Como conferir as categorias de desenvolvedor usando a API

Acessar uma categoria de desenvolvedor específica ou todas as categorias de desenvolvedor em uma organização.

Veja uma categoria de desenvolvedor específica emitindo uma solicitação GET para /mint/organizations/{org_name}/developer-categories/{category_id}, em que {category_id} é a identificação da categoria do desenvolvedor (o ID é retornado na resposta quando você adiciona a categoria). Exemplo:

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

Confira todas as categorias de desenvolvedores de API de uma organização emitindo uma solicitação GET para /mint/organizations/{org_id}/developer-categories. Exemplo:

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

Como editar uma categoria de desenvolvedor usando a API

Edite uma categoria de desenvolvedor emitindo uma solicitação PUT para /mint/organizations/{org_name}/developer-categories/{category_id}, em que {category_id} é a identificação da categoria a ser atualizada. É necessário especificar no corpo da solicitação as configurações atualizadas e o ID da categoria do desenvolvedor. Por exemplo, a solicitação a seguir edita a descrição de uma categoria de desenvolvedor:

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

Excluir uma categoria de desenvolvedor usando a API

Para excluir uma categoria de desenvolvedor, emita uma solicitação DELETE para /mint/organizations/{org_name}/developer-categories/{category_id}, em que {category_id} é a identificação da categoria a ser excluída. Por exemplo:

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

Propriedades de configuração da categoria de desenvolvedor para a API

A tabela a seguir resume as propriedades de configuração que podem ser definidas usando a API.

Nome	Descrição	Padrão	Obrigatório?
name	nomes de propriedades. Definido como MINT_DEVELOPER_CATEGORY.	N/A	Sim
value	ID da categoria de desenvolvedor a que o desenvolvedor foi adicionado.	N/A	Sim, para definir a categoria do desenvolvedor.