Gerenciar categorias de desenvolvedores

Você está vendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X.
informações

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, é possível criar planos de tarifas que se aplicam a todos os desenvolvedores que desenvolvem apps para participação na receita criando uma categoria de desenvolvedor chamada "revenue_sharing" e adicionando desenvolvedores a ela. Para mais informações sobre a criação de planos de preços com categorias do desenvolvedor, consulte Criar planos de preços.

Como explorar a página "Categorias de desenvolvedor"

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

interface do Edge

Para acessar a página Categorias de desenvolvimento:

  1. Faça login em apigee.com/edge.
  2. Selecione Publicação > Monetização > Categorias de desenvolvedores na barra de navegação à esquerda.

A página "Categorias de desenvolvedores" será exibida.

Como destacado na figura, a página "Categorias de desenvolvedores" permite:

  • Conferir as categorias de desenvolvedores atuais
  • Adicionar, editar ou excluir uma categoria de desenvolvedor

Borda clássica (nuvem privada)

Para acessar a página Desenvolver categorias usando a interface clássica do Edge:

  1. Faça login em http://ms-ip:9000, em que ms-ip é o endereço IP ou o nome DNS do nó do servidor de gerenciamento.
  2. Selecione Publicar > Categorias de desenvolvedores na barra de navegação superior.

A página "Categorias de desenvolvedores" será exibida.

A página "Categorias de desenvolvedor" permite:

  • Conferir as categorias de desenvolvedores atuais
  • Adicionar, editar ou excluir uma categoria de desenvolvedor

Como adicionar uma categoria de desenvolvedor

Para adicionar uma categoria de desenvolvedor usando a interface:

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

Adicionar uma empresa a uma categoria de desenvolvedor

Adicionar 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 superior.
  2. Selecione a empresa que você quer adicionar à categoria de desenvolvedor.
  3. Clique em Editar na página da empresa.
  4. Selecione a Categoria de desenvolvedor da empresa.
  5. Clique em Salvar.

Editar uma categoria de desenvolvedor

Para editar uma categoria de desenvolvedor usando a interface, faça o seguinte:

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

Como excluir uma categoria de desenvolvedor

Para excluir uma categoria de desenvolvedor usando a interface, faça o seguinte:

  1. Acesse a página de 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.

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, você especifica as categorias 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 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 empresa a uma categoria de desenvolvedor ao editá-la, envie uma solicitação PUT para os seguintes recursos, respectivamente:

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

Uma empresa ou um desenvolvedor pode pertencer a apenas uma categoria de desenvolvedor.

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

Como visualizar categorias de desenvolvedores usando a API

Confira uma categoria específica ou todas as categorias de desenvolvedores de uma organização.

Confira 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 de 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

Consulte todas as categorias de desenvolvedores de API de uma organização enviando 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

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 de 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

Exclua uma categoria de desenvolvedor emitindo 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 do 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_ worker_CATEGORY.

N/A Sim
value

ID da categoria de desenvolvedor a que o desenvolvedor foi adicionado.

N/A Sim, para definir a categoria de desenvolvedor.