Administrar categorías para desarrolladores

Estás viendo la documentación de Apigee Edge.
Ir a la documentación de Apigee X. info

Una categoría de desarrolladores es una agrupación de desarrolladores o empresas con características similares que te permite configurar la monetización para que opere en esa categoría específica. Por ejemplo, puedes crear planes de tarifas que se apliquen a todos los desarrolladores que desarrollen apps para compartir ingresos mediante la creación de una categoría de desarrolladores llamada "revenue_sharing" y la adición de desarrolladores a ella. Para obtener más información sobre cómo crear planes de tarifas con categorías de desarrolladores, consulta Crea planes de tarifas.

Explora la página Categorías de 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.

Agrega una categoría de desarrolladores

Para agregar una categoría de desarrolladores con la IU, haz lo siguiente:

1. Accede a la página Categorías de desarrolladores.
2. Haz clic en + Categoría de desarrolladores.
3. Ingresa un nombre para la categoría nueva y una descripción breve.
4. Haz clic en Crear categoría de desarrolladores.

Agrega una empresa a una categoría de desarrolladores

Agrega una empresa a una categoría de desarrolladores. Una empresa puede pertenecer a una sola categoría de desarrolladores.

Para agregar una empresa a una categoría de desarrolladores, haz lo siguiente:

1. Selecciona Publicar > Empresas en la barra de navegación superior.
2. Selecciona la empresa que deseas agregar a la categoría de desarrolladores.
3. Haz clic en Editar en la página de la empresa.
4. Selecciona la Categoría de desarrolladores para la empresa.
5. Haz clic en Guardar.
   

Edita una categoría de desarrolladores

Para editar una categoría de desarrolladores con la IU, haz lo siguiente:

1. Accede a la página Categorías de desarrolladores.
2. Coloca el cursor sobre la categoría de desarrolladores que deseas editar y haz clic en .
3. Ingresa la categoría de desarrolladores.
4. Haz clic en Actualizar categoría de desarrolladores.

Borra una categoría de desarrolladores

Para borrar una categoría de desarrolladores con la IU, haz lo siguiente:

1. Accede a la página Categorías de desarrolladores.
2. Coloca el cursor sobre la categoría de desarrolladores que deseas editar.
3. Haz clic en .
4. Haz clic en Borrar para confirmar la operación.

Administra categorías de desarrolladores con la API

Administra categorías de desarrolladores con la API, como se describe en las siguientes secciones.

Agrega una categoría de desarrolladores con la API

Para agregar una categoría de desarrolladores, envía una solicitud POST a /mint/organizations/{org_name}/developer-categories.

Cuando envíes la solicitud, debes especificar el name y description de la categoría 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"
}

Agrega un desarrollador o una empresa a una categoría de desarrolladores con la API

Agrega un desarrollador o una empresa a una categoría de desarrolladores 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 desarrolladores cuando edites la empresa o el desarrollador, envía 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 puede pertenecer a una sola categoría de desarrolladores.

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 ya existente a la categoría de desarrolladores denominada "Gold", 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

Visualiza categorías de desarrolladores con la API

Visualiza una categoría de desarrolladores específica o todas las categorías de desarrolladores de una organización.

Para visualizar una categoría de desarrolladores específica, envía una solicitud GET a /mint/organizations/{org_name}/developer-categories/{category_id}, donde {category_id} es la identificación de la categoría de desarrolladores (el ID se muestra en la respuesta cuando agregas la categoría de desarrolladores). 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

Para visualizar todas las categorías de desarrolladores de API de una organización, envía una solicitud GET a /mint/organizations/{org_id}/developer-categories. Por ejemplo:

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

Edita una categoría de desarrolladores con la API

Para editar una categoría de desarrolladores, envía una solicitud PUT a /mint/organizations/{org_name}/developer-categories/{category_id}, donde {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 desarrolladores. Por ejemplo, la siguiente solicitud edita la descripción de una categoría de desarrolladores:

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

Borra una categoría de desarrolladores con la API

Para borrar una categoría de desarrolladores, envía una solicitud DELETE a /mint/organizations/{org_name}/developer-categories/{category_id}, donde {category_id} es la identificación de la categoría de desarrolladores 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ías de desarrolladores para la API

En la siguiente tabla, se resumen las propiedades de configuración que se pueden establecer con la API.