Administrar empresas y desarrolladores con Edge

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

Si quieres tener más control sobre las empresas y los desarrolladores que participan en tu programa de API monetizado (por ejemplo, si quieres crear empresas y desarrolladores internos para realizar pruebas), puedes crear empresas y desarrolladores de forma manual con la IU de administración y la API.

Una consideración principal que determina si necesitas crear empresas y desarrolladores de forma manual es si los desarrolladores necesitarán credenciales para acceder a la IU de administración, enviar credenciales en llamadas a la API de administración de Edge o acceder a un portal para desarrolladores.

• Si tus desarrolladores de monetización necesitan credenciales de acceso para acceder a la IU o la API de Edge, primero deben tener su propia cuenta de administrador de Apigee.
• Si solo necesitas crear desarrolladores de prueba que no necesiten credenciales (por ejemplo, si quieres realizar llamadas a la API con desarrolladores de prueba ficticios), no se requieren cuentas de Apigee.

Administra desarrolladores de apps con la IU

Crea, administra y activa desarrolladores de apps con la IU de Edge, como se describe en Administra desarrolladores de apps. Después de crear los desarrolladores de apps, puedes agregarlos a las empresas, como se describe en las siguientes secciones.

Administra empresas con la IU

Crea, administra y activa empresas, como se describe en las siguientes secciones.

Explora la página Empresas

Accede a la página Empresas, como se describe a continuación.

Agrega una empresa

Para agregar una empresa, sigue estos pasos:

1. Accede a la página Empresas.
2. Haz clic en + Empresa.
3. Ingresa los detalles de la empresa.

   Los siguientes son los campos obligatorios:

   • Nombre de la empresa
   • Administrador (el usuario que es el administrador principal de la empresa )
   • Tipo de facturación

   Según la configuración de facturación de la monetización, el tipo de facturación puede establecerse de forma predeterminada en PREPAID o POSTPAID. Para obtener más información, consulta Configura los tipos de facturación prepaga y pospaga con la API.

4. Agrega uno o más desarrolladores a la empresa.
   1. En la sección Desarrolladores, ingresa una cadena en el campo Agregar desarrollador para mostrar la lista de desarrolladores que coinciden con la cadena.
   2. Selecciona un desarrollador de la lista desplegable.
   3. Repite el proceso para agregar desarrolladores adicionales a la empresa.
5. Agrega uno o más atributos personalizados.
   1. En la sección Atributos personalizados, haz clic en + Nuevo.
   2. Ingresa el nombre y el valor del atributo personalizado.
   3. Repite el proceso para agregar atributos personalizados adicionales a la empresa.
6. Haz clic en Crear empresa.

Activa y desactiva una empresa

Para activar y desactivar una empresa, sigue estos pasos:

1. Accede a la página Empresa.
2. Coloca el cursor sobre la empresa que deseas activar y habilita en el menú de acciones.
   Inhabilita el botón de activación para desactivar la empresa.

Edita una empresa

Para editar una empresa, sigue estos pasos:

1. Accede a la página Empresa.
2. Coloca el cursor sobre la empresa que deseas editar y haz clic en en el menú de acciones.
3. Actualiza los detalles de la empresa según sea necesario.
4. Haz clic en Actualizar empresa para guardar los cambios.

Borra una empresa

Para borrar una empresa, sigue estos pasos:

1. Accede a la página Empresas.
2. Coloca el cursor sobre la empresa que deseas borrar y haz clic en en el menú de acciones.
3. Haz clic en Borrar para confirmar la operación de borrado.

Administra empresas y desarrolladores con la API

El uso de la API para administrar empresas y desarrolladores se describe en las siguientes secciones.

Crea y actualiza empresas y desarrolladores con la API

Para administrar empresas y desarrolladores con la API de administración de Edge, consulta las siguientes secciones de la API:

• Crea una empresa
• Crea un desarrollador
  Nota: Configura la información de monetización cuando crees un desarrollador pasando atributos personalizados.
• Agrega o actualiza desarrolladores de la empresa
  Nota: De manera opcional, puedes asignar un rol al desarrollador, aunque no es obligatorio. Para obtener una lista de roles de desarrollador, consulta Recupera roles de desarrollador.
• Enumera la configuración de monetización para todos los desarrolladores o para un solo desarrollador
  Nota: Define la información de monetización pasando atributos personalizados cuando crees o actualices un desarrollador. Puedes ver los atributos personalizados de monetización establecidos con la API estándar (no de monetización) para enumerar todos los desarrolladores o un solo desarrollador.

Administra roles de desarrollador con la API

Puedes crear roles con las APIs de monetización. Esto te permite establecer roles para tus socios. Por ejemplo, puedes establecer roles de administrador y desarrollador de aplicaciones para un socio. Luego, esos roles se pueden asignar a empleados específicos del socio.

Crea un rol de desarrollador

Para crear un rol de desarrollador, envía una solicitud POST a organizations/{org_name}/developer-roles. Cuando realices la solicitud, deberás especificar en el cuerpo de la solicitud el nombre y la descripción del rol, y la identificación de la organización. Por ejemplo:

$ curl -H "Content-Type:application/json" -X POST -d \
'{
   "name": "appDeveloper",
   "description": "App Developer",
   "organization": {
       "id": "{org_name}"
   }
 }' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developer-roles" \
-u email:password

Recupera roles de desarrollador

Para recuperar roles de desarrollador, envía una solicitud GET a organizations/{org_id}/developer-roles. Por ejemplo:

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

La respuesta debería ser similar a la siguiente (solo se muestra una parte de la respuesta):

{
  "description" : "App Developer",
  "id" : "appdeveloper",
  "name" : "appDeveloper",
  "organization" : {
   ...
  }
}

Configuración de roles de desarrollador para la API

Las siguientes opciones de configuración de roles de desarrollador se exponen a la API:

Recupera la tasa de impuestos de un desarrollador con la API

Puedes obtener la tasa de impuestos actual de un desarrollador enviando una solicitud GET a organizations/{org_name}/tax-engine. Cuando realices la solicitud, deberás especificar la identificación del desarrollador como un parámetro de consulta. Por ejemplo:

$ curl -H "Accept:application/json" -X GET \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/tax-engine?developerId=dev7@myorg.com" \
-u email:password

La respuesta debería ser similar a la siguiente:

0.09

Realiza otras tareas específicas del desarrollador con la API

Muchas de las tareas relacionadas con la monetización que puedes realizar para una organización, como crear planes de tarifas o crear condiciones de notificación, también puedes realizarlas para un desarrollador individual. Por ejemplo, puedes crear una cuenta bancaria para un desarrollador específico o generar un informe de ingresos para un desarrollador específico.

En la siguiente tabla, se enumeran las tareas específicas del desarrollador que puedes realizar con las APIs de monetización. En la tabla, también se indica dónde puedes encontrar instrucciones detalladas para realizar estas tareas.