Administrar categorías para desarrolladores

Estás viendo la documentación de Apigee Edge.
Ve a la Documentación de Apigee X. información

Una categoría de desarrollador es un grupo de desarrolladores o empresas con características similares que permiten que configures la monetización para que opere en esa categoría específica. Por ejemplo, pueden crear planes de tarifas que se aplican a todos los desarrolladores que desarrollan apps para el reparto de ingresos crear una categoría de desarrollador llamada "revenue_sharing" y agregarle desarrolladores. Para ver más Para obtener información sobre cómo crear planes de tarifas con categorías de desarrolladores, consulta Cómo crear planes de tarifas.

Exploración de 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.

Cómo agregar una categoría de desarrollador

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

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

Cómo 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:

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

Cómo editar una categoría de desarrollador

Para editar una categoría de desarrollador por medio de la IU, sigue estos pasos:

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

Cómo borrar una categoría de desarrollador

Para borrar una categoría de desarrollador por medio de la IU, haz lo siguiente:

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

Administra categorías de desarrollador con la API

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

Cómo agregar una categoría de desarrollador con la API

Agrega una categoría de desarrollador mediante el envío de una solicitud POST a /mint/organizations/{org_name}/developer-categories

Cuando envías 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"
}

Cómo agregar un desarrollador o una empresa a una categoría de desarrollador con la API

Agrega un desarrollador o una empresa a una categoría de desarrollador cuando agregues o edites la empresa o desarrollador, emitiendo un 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 editas la empresa o el desarrollador, emite una 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 como el ID interno de la categoría. Por ejemplo, la siguiente solicitud agrega una ya existente desarrollador de la categoría de desarrollador "Gold" categoría, que tiene el 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 desarrollador mediante la API

Consulta una categoría de desarrollador específica o todas las categorías de desarrollador 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}, donde {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

Para ver todas las categorías de desarrollador 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

Cómo editar una categoría de desarrollador con la API

Edita una categoría de desarrollador mediante el envío de 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 del desarrollador. categoría. 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 con la API

Para borrar una categoría de desarrollador, 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 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ías de desarrollador para la API

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