Estás consultando la documentación de Apigee Edge.
Consulta la
documentación de Apigee X. Información
En este tema, se proporciona información y orientación para solucionar problemas de monetización que se observan con frecuencia.
Desarrollador suspendido
Síntoma
El desarrollador está suspendido y no podrá realizar transacciones de monetización adicionales ni llamadas a la API.
Mensajes de error
<error> <messages> <message>Exceeded developer limit configuration -</message> <message>Is Developer Suspended - true</message> </messages> </error>
Diagnóstico
Para determinar el motivo de la suspensión del desarrollador, sigue estos pasos:
- Ejecuta la siguiente llamada a la API para identificar el código de error asociado con el desarrollador suspendido:
- Si eres usuario de la nube pública, usa la siguiente API:
curl -X GET "https://api.enterprise.apigee.com/v1/mint/organizations/{org}/suspended-developers/{developer-email}" -u orgadminEmail:password
- Si eres usuario de la nube privada, usa la siguiente API:
curl -X GET "http://<management-host>:<port#>/v1/mint/organizations/{org}/suspended-developers/{developer-email}" -u orgadminEmail:password
- Si eres usuario de la nube pública, usa la siguiente API:
- Compara el código de error con los siguientes códigos de motivos para determinar por qué se suspendió al desarrollador.
Consulta también: Resumen de códigos de motivos para desarrolladores suspendidos
Código del motivo |
Causa |
Detalles |
INSUFFICIENT_FUNDS |
Se agotó el saldo de la cuenta de desarrollador |
Si el saldo prepagado de la cuenta de desarrollador no tiene fondos suficientes para realizar transacciones adicionales, se suspenderá al desarrollador. En el caso de los desarrolladores de pospago, este error puede ocurrir si superan su límite de crédito o si se agota el límite de crédito establecido en la moneda que se usó. |
LIMIT_VIOLATED RATE_PLAN_RATE_BAND_EXCEEDED |
El desarrollador no puede realizar más transacciones |
Cada desarrollador puede realizar una cantidad fija de transacciones según el plan de tarifas comprado. Si se excede la cantidad de transacciones, el desarrollador se suspenderá y no podrá completar transacciones adicionales. |
NO_CURRENT_PUBLISHABLE_ENTITY |
El desarrollador no compró ningún plan de tarifas |
El desarrollador debe comprar un plan de tarifas antes de completar cualquier transacción. |
Resolución
Error |
Pasos para resolver el problema |
INSUFFICIENT_FUNDS |
El desarrollador debe asegurarse de que haya suficiente saldo de cuenta o crédito disponible para completar cualquier transacción adicional. |
LIMIT_VIOLATED RATE_PLAN_RATE_BAND_EXCEEDED |
|
NO_CURRENT_PUBLISHABLE_ENTITY |
El desarrollador debe comprar un plan de tarifas para poder hacer llamadas a la API. |
Problemas de configuración de monetización
Síntomas
Los problemas de configuración de la monetización pueden manifestarse como diferentes síntomas, como los siguientes:
- La funcionalidad de webhooks no funciona
- No se pueden crear webhooks
- No se activan las notificaciones de webhook
- Los informes de monetización no muestran transacciones. Por ejemplo, los datos de Analytics indican que el desarrollador completó muchas transacciones en un período específico, pero no se muestra ninguna en los informes de monetización.
- No se registran las transacciones
Mensajes de error
Es posible que no veas ningún mensaje de error, pero verás problemas como se explica en la sección Síntomas.
Causas posibles
Si ves alguno de los síntomas que se mencionan en Síntomas, es muy probable que las transacciones no se estén monetizando.
Diagnostica la causa
-
Usa la llamada a la API de administración que se describe en la siguiente sección para verificar si se están monetizando las transacciones.
- Si no ves ninguna transacción con el estado SUCCESS en la duración especificada, no se monetizan.
Las causas típicas de que las transacciones no se monetizan son las siguientes:
- Política de verificación de límites de monetización no adjunta al proxy de API
- El producto de la API no está monetizado
- La política de registro de transacciones se definió de forma incorrecta
- El desarrollador no compró el plan de tarifas
En las siguientes secciones, se describe cómo diagnosticar y resolver cada problema.
No se usa la política de verificación de límites de monetización en el proxy de API
Diagnóstico
- Verifica si se adjunta la Política de verificación de límites de monetización a los proxies de API.
- Si no se adjunta la política, esta podría ser la razón por la que las transacciones se muestran como FAILED.
Resolución
Adjunta la Política de verificación de límites de monetización a los proxies de API obligatorios, como se describe en Aplica límites de monetización en proxies de API.
Si el problema persiste, verifica que el producto de API no esté monetizado.
El producto de API no está monetizado
Diagnóstico
- Verifica si el producto de API está monetizado (solo los productos de API monetizados están clasificados y se incluirán en transacciones). Un producto monetizado es aquel que tiene al menos un plan de tarifas activo disponible.
- Usa la siguiente llamada a la API de administración para obtener la lista de productos de API monetizados:
- Si eres usuario de la nube pública, usa la siguiente API:
curl -v https://api.enterprise.apigee.com/v1/mint/organizations/{org_id}/products?monetized=true -u orgadminEmail:password
- Si eres usuario de la nube privada, usa la siguiente API:
curl -v http://<management-host>:<port#>/v1/mint/organizations/{org_id}/products?monetized=true -u orgadminEmail:password
- Si eres usuario de la nube pública, usa la siguiente API:
- Si el producto de API asociado con tu proxy de API no está monetizado, esta podría ser la razón por la que las transacciones no se están monetizando.
Resolución
Para monetizar un producto de API, sigue estos pasos:
- Configura la política de registro de transacciones.
- Verifica que el producto de API tenga un plan de tarifas activo.
Si el problema persiste, revisa la Política de registro de transacciones definida de forma incorrecta.
La política de registro de transacciones se definió incorrectamente
Diagnóstico
- Habilita el seguimiento de IU para el proxy de API que tiene adjunta la Política de verificación de límites de monetización.
- Selecciona una solicitud a la API en particular del seguimiento de la IU.
- Selecciona el flujo AX de Analytics y verifica si las siguientes variables de flujo de monetización (mentt)
tienen los valores adecuados:
mint.tx.status - Should match the value set up for "success criteria" in the transaction recording policy for the API product being used. When tracing, the txProviderStatus in the transaction recording policy is stored in the variable 'mint.tx.status'. mint.tx.app_id - Application id of API product. mint.tx.prod_id - API product id.
Este es un ejemplo de seguimiento de la IU que muestra que las variables de flujo de menta están configuradas correctamente.
- Si observas un error en la variable
mint.tx.status
, significa que la política de registro de transacciones está definida de forma incorrecta.
Resolución
- Asegúrate de que se hayan seguido correctamente todos los pasos documentados en Crea una política de registro de transacciones mientras se creó la política de registro de transacciones.
- El valor clave es los “criterios de éxito de la transacción” que se establecen en la política de registro de transacciones. Consulta Ejemplos para configurar criterios de éxito de transacciones en una política de registro de transacciones
El desarrollador no compró el plan de tarifas
Diagnóstico
- Usa la siguiente llamada a la API de administración para verificar los planes de tarifas que compró el desarrollador:
- Si eres usuario de la nube pública, usa la siguiente API:
curl -v https://api.enterprise.apigee.com/v1/mint/organizations/{org}/developers/{dev_email}/products/{prod}/developer-rateplans -u orgadminEmail:password
- Si eres usuario de la nube privada, usa la siguiente API:
curl -v http://<management-host>:<port#>/v1/mint/organizations/{org}/developers/{dev_email}/products/{prod}/developer-rateplans -u orgadminEmail:password
- Si eres usuario de la nube pública, usa la siguiente API:
- Según la respuesta de la llamada anterior, encuentra el plan que estaba activo en el momento en que el desarrollador completó la transacción.
Resolución
El desarrollador debe comprar el plan de tarifas según sus requisitos y, luego, ejecutar las transacciones o las APIs.
Si el problema persiste, comunícate con el equipo de asistencia de Apigee Edge.