Estás consultando la documentación de Apigee Edge.
Consulta la
documentación de Apigee X. Información
Una categoría de desarrollador es una agrupación de desarrolladores o empresas con características similares que te permite configurar la monetización para operar en esa categoría específica. Por ejemplo, puedes crear planes de tarifas que se apliquen a todos los desarrolladores que desarrollan apps para el reparto de ingresos creando una categoría de desarrollador llamada "revenue_sharing" y agregándoles desarrolladores. Si quieres obtener más información para crear planes de tarifas con categorías de desarrolladores, consulta Cómo crear planes de tarifas.
Explora la página Categorías para desarrolladores
Accede a la página Categorías de desarrolladores con la IU de Edge o la IU clásica de Edge, como se describe en las siguientes secciones.
IU de Edge
Para acceder a la página Develop Categories:
- Accede a apigee.com/edge.
- En la barra de navegación izquierda, selecciona Publish > Monetization > Developer Categories.
Se mostrará la página Categorías del desarrollador.
Como se muestra en la imagen, la página Categorías para desarrolladores te permite hacer lo siguiente:
- Ver las categorías para desarrolladores actuales
- Cómo agregar, editar o borrar una categoría de desarrollador
Versión clásica de Edge (nube privada)
Para acceder a la página Develop Categories con la IU clásica de Edge, haz lo siguiente:
- Accede a
http://ms-ip:9000
, donde ms-ip es la dirección IP o el nombre de DNS del nodo del servidor de administración. - En la barra de navegación superior, selecciona Publicar > Categorías de desarrolladores.
Se mostrará la página Categorías del desarrollador.
La página Categorías para desarrolladores te permite hacer lo siguiente:
- Ver las categorías para desarrolladores actuales
- Cómo agregar, editar o borrar una categoría de desarrollador
Cómo agregar una categoría de desarrollador
Para agregar una categoría de desarrollador con la IU, haz lo siguiente:
- Accede a la página Develop Categories.
- Haz clic en + Categoría de desarrollador.
- Ingresa un nombre para la categoría nueva y una descripción breve.
- Haz clic en Crear categoría de desarrollador.
Agregar una empresa a una categoría de desarrollador
Agrega una empresa a una categoría de desarrollador. Una empresa puede pertenecer a una sola categoría de desarrollador.
Para agregar una empresa a una categoría de desarrollador, haz lo siguiente:
- Seleccione Publicar > Empresas en la barra de navegación superior.
- Selecciona la empresa que deseas agregar a la categoría de desarrollador.
- Haz clic en Editar en la página de la empresa.
- Selecciona la Categoría del desarrollador de la empresa.
- Haz clic en Guardar.
Editar una categoría de desarrollador
Para editar una categoría de desarrollador con la IU, haz lo siguiente:
- Accede a la página Develop Categories.
- Coloca el cursor sobre la categoría de desarrollador que quieras editar y haz clic en .
- Ingresa la categoría de desarrollador.
- Haz clic en Actualizar categoría de desarrollador.
Cómo borrar una categoría de desarrollador
Para borrar una categoría de desarrollador con la IU, haz lo siguiente:
- Accede a la página Develop Categories.
- Coloca el cursor sobre la categoría de desarrollador que quieras editar.
- Haz clic en .
- Haz clic en Borrar para confirmar la operación.
Administra las categorías para desarrolladores mediante la API
Administra las categorías de desarrollador con la API, como se describe en las siguientes secciones.
Agrega una categoría de desarrollador mediante la API
Para agregar una categoría de desarrollador, envía una solicitud POST a /mint/organizations/{org_name}/developer-categories
.
Cuando emites la solicitud, especificas la categoría name
y description
en la carga útil. Por ejemplo:
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 respuesta debería ser similar a la siguiente:
{ "description" : "Gold membership", "id" : "aa6f960a-d9fd-416e-be39-c071418aabd0", "name" : "Gold" }
Agregar un desarrollador o una empresa a una categoría de desarrollador mediante la API
Agrega un desarrollador o una empresa a una categoría de desarrollador cuando agregues o edites la empresa o el desarrollador enviando una solicitud POST a los siguientes recursos, respectivamente:
- /organizations/{org_name}/companies
- /organizations/{org_name}/developers
Para agregar un desarrollador o una empresa a una categoría de desarrollador cuando los editas, emite una solicitud PUT a los siguientes recursos, respectivamente:
- /organizations/{org_name}/companies/{company_id}
- /organizations/{org_name}/developers/{developer_id}
Una empresa o un desarrollador pueden pertenecer a una sola categoría de desarrollador.
Especifica MINT_DEVELOPER_CATEGORY
como un atributo en el cuerpo de la solicitud con el ID interno de la categoría como valor. Por ejemplo, la siguiente solicitud agrega un desarrollador existente a la categoría de desarrolladores llamada "Oro", que tiene un 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
Cómo ver las categorías de desarrolladores mediante la API
Ver una categoría de desarrollador específica o todas las categorías de desarrolladores de una organización
Para ver una categoría de desarrollador específica, envía una solicitud GET a /mint/organizations/{org_name}/developer-categories/{category_id}
, en la que {category_id}
es la identificación de la categoría de desarrollador (el ID se muestra en la respuesta cuando agregas la categoría de desarrollador). Por ejemplo:
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
Envía una solicitud GET a /mint/organizations/{org_id}/developer-categories
para ver todas las categorías de desarrolladores de API de una organización. Por ejemplo:
curl -X GET "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developer-categories" \ -H "Accept:application/json" \ -u email:password
Cómo editar una categoría de desarrollador con la API
Para editar una categoría de desarrollador, emite una solicitud PUT a /mint/organizations/{org_name}/developer-categories/{category_id}
, en la que {category_id}
es la identificación de la categoría que se actualizará. Debes especificar en el cuerpo de la solicitud la configuración actualizada y el ID de la categoría de desarrollador. Por ejemplo, la siguiente solicitud edita la descripción de una categoría de desarrollador:
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
Cómo borrar una categoría de desarrollador mediante la API
Para borrar una categoría de desarrollador, envía una solicitud DELETE a /mint/organizations/{org_name}/developer-categories/{category_id}
, en la que {category_id}
es la identificación de la categoría de desarrollador que se borrará. Por ejemplo:
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
Propiedades de configuración de categoría de desarrollador para la API
En la siguiente tabla, se resumen las propiedades de configuración que se pueden configurar con la API.
Nombre | Descripción | Predeterminada | ¿Obligatorio? |
---|---|---|---|
name |
El nombre de la propiedad Se define en MINT_developer_CATEGORY. |
No disponible | Sí |
value |
ID de la categoría de desarrollador a la que se agregó el desarrollador |
No disponible | Sí, para establecer la categoría de desarrollador |