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:
- Faça login em apigee.com/edge.
- 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:
Borda clássica (nuvem privada)
Para acessar a página Desenvolver categorias usando a interface clássica do Edge:
- 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. - 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:
Como adicionar uma categoria de desenvolvedor
Para adicionar uma categoria de desenvolvedor usando a interface:
- Acesse a página de categorias de desenvolvimento.
- Clique em + Categoria do desenvolvedor.
- Insira um nome para a nova categoria e uma breve descrição.
- 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:
- Selecione Publicar > Empresas na barra de navegação superior.
- Selecione a empresa que você quer adicionar à categoria de desenvolvedor.
- Clique em Editar na página da empresa.
- Selecione a Categoria de desenvolvedor da empresa.
- Clique em Salvar.
Editar uma categoria de desenvolvedor
Para editar uma categoria de desenvolvedor usando a interface, faça o seguinte:
- Acesse a página de categorias de desenvolvimento.
- Posicione o cursor sobre a categoria de desenvolvedor que você quer editar e clique em .
- Insira a categoria de desenvolvedor.
- 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:
- Acesse a página de categorias de desenvolvimento.
- Posicione o cursor sobre a categoria de desenvolvedor que você quer editar.
- Clique em .
- 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. |