Estás consultando la documentación de Apigee Edge.
Consulta la
documentación de Apigee X. Información
La monetización proporciona un conjunto de APIs que puedes usar para anular la suspensión de un desarrollador que se suspendió anteriormente, como se describe en las siguientes secciones. Es posible que se suspenda a un desarrollador si se alcanza el límite configurado. Por ejemplo, la cantidad de transacciones alcanzó su límite máximo o el saldo de una cuenta prepaga se agotó. Si quieres obtener una lista completa de códigos de motivo, consulta el resumen de códigos de motivos para desarrolladores suspendidos.
Cómo ver todos los desarrolladores suspendidos que usan la API
Para ver todos los desarrolladores suspendidos de una organización, emite una solicitud GET al siguiente
recurso: /organizations/{org_name}/suspended-developers
.
Donde:
{org_name}
especifica el nombre de la organización.
Por ejemplo, en la siguiente llamada cURL, se enumera a todos los desarrolladores suspendidos de myorg
:
curl -H "Content-Type: application/json" -X GET \ "https://api.enterprise.apigee.com/v1/mint/organizations/myorg/suspended-developers" \ -u email:password
A continuación, se proporciona un ejemplo de respuesta:
[ { "creationDate": 1464388723633, "devId": "myorg@@@6Vro7VnjUhpGVn3p", "id": "myorg-myorg@@@6Vro7VnjUhpGVn3p-myorg@@@myproduct-null-RATE_PLAN_RATE_BAND_EXCEEDED", "message": "mint.productHasBeenSuspended for myorg@@@6Vro7VnjUhpGVn3p myorg@@@myproduct due to RATE_PLAN_RATE_BAND_EXCEEDED", "orgId": "myorg", "prodId": "myorg@@@myproduct", "reasonCode": "RATE_PLAN_RATE_BAND_EXCEEDED" }, { "creationDate": 1464022846293, "devId": "myorg@@@vXh7LXxtUy9COVdy", "id": "myorg-myorg@@@vXh7LXxtUy9COVdy-myorg@@@myproduct-null-NO_CURRENT_PUBLISHABLE_ENTITY", "message": "mint.productHasBeenSuspended for myorg@@@vXh7LXxtUy9COVdy myorg@@@myproduct due to mint.noCurrentPublishableEntity", "orgId": "myorg", "prodId": "myorg@@@myproduct", "reasonCode": "NO_CURRENT_PUBLISHABLE_ENTITY" } ]
Cómo ver un desarrollador suspendido mediante la API
Envía una solicitud GET al siguiente recurso para ver el desarrollador suspendido de una organización: /organizations/{org_name}/suspended-developers/{developer_email_or_id}
.
Donde:
{org_name}
especifica el nombre de la organización.{developer_email_or_id}
especifica el ID del desarrollador. Para ver una lista de desarrolladores, consulta Lista de desarrolladores.
Por ejemplo, en la siguiente llamada cURL, se enumeran los detalles del desarrollador suspendido joe@example.com
:
curl -H "Content-Type: application/json" -X GET \ "https://api.enterprise.apigee.com/v1/mint/organizations/myorg/suspended-developers/joe@example.com" \ -u email:password
A continuación, se proporciona un ejemplo de respuesta:
[ { "creationDate": 1464388723633, "devId": "myorg@@@6Vro7VnjUhpGVn3p", "id": "myorg-myorg@@@6Vro7VnjUhpGVn3p-myorg@@@myproduct-null-RATE_PLAN_RATE_BAND_EXCEEDED", "message": "mint.productHasBeenSuspended for myorg@@@6Vro7VnjUhpGVn3p myorg@@@myproduct due to RATE_PLAN_RATE_BAND_EXCEEDED", "orgId": "myorg", "prodId": "myorg@@@myproduct", "reasonCode": "RATE_PLAN_RATE_BAND_EXCEEDED" } ]
Anula la suspensión de todos los desarrolladores de un producto de API mediante la API
Para anular la suspensión de todos los desarrolladores suspendidos de un producto de API, emite una solicitud POST al siguiente recurso: /organizations/{org_name}/suspended-developers/unsuspend-by-product/{suspendedProduct_id}
.
Donde:
{org_name}
especifica el nombre de la organización.{suspendedProduct_id}
especifica el ID del producto de API con un formato similar al siguiente:{org_id}@@@{product_id}
. Este valor se muestra comoprodId
cuando ves todos los desarrolladores suspendidos o específicos, tal como se describe en las secciones Cómo ver todos los desarrolladores suspendidos que usan la API y Cómo ver un desarrollador suspendido con la API.
Por ejemplo, la siguiente llamada a cURL anula la suspensión de todos los desarrolladores del producto de API myorg@@@myproduct
:
curl -H "Content-Type: application/json" -X POST \ "https://api.enterprise.apigee.com/v1/mint/organizations/myorg/suspended-developers/unsuspend-by-product/myorg@@@myproduct" \ -u email:password
Anula la suspensión de un desarrollador mediante la API
Para anular la suspensión de un desarrollador específico, envía una solicitud DELETE al siguiente recurso: /organizations/{org_name}/suspended-developers/{suspendedDev_id}.
Donde:
{org_name}
especifica el nombre de la organización.{suspendedDev_id}
especifica el ID del desarrollador suspendido con un formato similar al siguiente:{org_id}@@@{dev_id}
. Este valor se muestra comodevId
cuando ves a todos los desarrolladores suspendidos o específicos, tal como se describe en las secciones Cómo ver todos los desarrolladores suspendidos que usan la API y Cómo ver un desarrollador suspendido con la API.
De manera opcional, puedes pasar el siguiente parámetro de consulta:
Parámetro de consulta | Descripción |
---|---|
suspendedProduct_id |
Es el ID del producto de API con un formato similar al siguiente: {org_id}@@@{product_id} . Este valor se muestra como prodId cuando ves a todos los desarrolladores suspendidos o a desarrolladores suspendidos específicos, según se describe en Cómo ver todos los desarrolladores suspendidos que usan la API y Cómo ver un desarrollador suspendido con la API. |
Por ejemplo, la siguiente llamada cURL anula la suspensión del desarrollador con el ID myorg@@@6Vro7VnjUhpGVn3p
para el producto de API myorg@@@myproduct
:
curl -H "Content-Type: application/json" -X DELETE \ "https://api.enterprise.apigee.com/v1/mint/organizations/myorg/suspended-developers/myorg@@@6Vro7VnjUhpGVn3p?productId=myorg@@@myproduct" \ -u email:password
Resumen de códigos de motivo para desarrolladores suspendidos
En la siguiente tabla, se resumen los códigos de motivos que indican por qué se suspendió a un desarrollador.
Código del motivo | Descripción |
---|---|
INSUFFICIENT_FUNDS |
Se agotó la cuenta de desarrollador. |
LIMIT_VIOLATED |
Se alcanzó el límite configurado para la cuenta de desarrollador. |
NO_CURRENT_PUBLISHABLE_ENTITY |
El desarrollador no aceptó (se suscribió) un plan de tarifas. |
RATE_PLAN_RATE_BAND_EXCEEDED |
Se alcanzó el límite configurado de la banda de volumen final. |