Cómo migrar a los desarrolladores a la monetización

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

Si tienes desarrolladores existentes que deben migrar a la monetización, haz lo siguiente:

  1. Crear los productos de API, los paquetes de API y los planes de tarifas para los desarrolladores que te interesan migrando, si aún no existen. Para obtener más información, consulta lo siguiente:
  2. Publica los planes de tarifas, como se describe en Publicación de planes de tarifas.
  3. Agrega los desarrolladores nuevos a tu organización, como se describe en Registra desarrolladores de apps.
  4. Recarga el saldo prepagado para cada desarrollador, como se describe en Cómo administrar una cuenta prepagada. saldos.
  5. Aceptar el plan de tarifas, como se describe en Porcentaje de compras con la API.

    Nota: Para renunciar a las tarifas de configuración, si ya se le cobró a un desarrollador, establece la Parámetro de consulta de waivefees a true.

  6. Si un desarrollador que migras tiene transacciones existentes puedes transferir de forma manual el uso de la transacción con el siguiente recurso:
    /organizations/{org_name}/transactions, donde {org_name} es el valor de el nombre de la organización.

    Nota: Si un desarrollador no tiene transacciones existentes, puedes omitir este paso. paso.

    El recurso transactions inserta una sola transacción que refleja el el uso actual de la transacción y actualiza todos los contadores internos para reflejar este nuevo valor.

    Por ejemplo, si el desarrollador emitió 1,000 llamadas a la API antes de la migración, capturar la actividad actual, puedes establecer el uso de la transacción en 1000 llamando al recurso transactions y establecer la propiedad batchSize en 1,000 en el cuerpo de la solicitud.

    En la siguiente tabla, se resumen las propiedades de configuración que puedes especificar en los cuerpo de la solicitud para establecer manualmente la cantidad de transacciones, sus valores predeterminados y si pero no son obligatorios.

    Propiedad Descripción Predeterminada ¿Obligatorio?
    application

    Es el ID de la app del desarrollador.

    N/A
    batchSize

    Cantidad de transacciones que quieres transferir.

    1 No
    custAttn

    Valor del atributo personalizado que se usa con batchSize para calcular la el uso de transacciones.

    El número del atributo personalizado en el mensaje se debe especificar como un número entero positivo. o decimal (hasta cuatro decimales). No se permiten valores negativos.

    El atributo personalizado se debe definir en las siguientes ubicaciones:

    N/A
    product

    Es el ID del producto de API.

    N/A
    type

    Se debe configurar en CHARGE (que es el valor predeterminado).

    CHARGE No

    Para omitir los pasos de validación y forzar el número de transacciones, configura la El parámetro de consulta force a true (por ejemplo, ?force=true). De forma predeterminada, ?force=false y los pasos de validación se ejecutado. Por ejemplo, si un desarrollador con una cuenta prepagada tiene un saldo y actividad de cero en la cuenta se suspende. Si ?force=false, la solicitud fallará durante la validación.

    Por ejemplo, la siguiente solicitud establece el número de transacciones en 50 para la cantidad especificada de la aplicación y el producto de API:

    $ curl -H "Content-Type:application/json" -X POST -d \
    '{ 
       "application":{
         "id":"6a9b1afc-2110-43d6-bae7-1b137aecb05b"
       },
       "product":{
         "id":"testproduct"
       },
       "batchSize":50
    }' \
    "https://api.enterprise.apigee.com/v1/mint/organizations/myOrg/transactions" \
    -u email:password
    

    La siguiente solicitud establece el uso de la transacción en 12.5 para la aplicación especificada y producto de API. En la solicitud, batchSize se establece en 125, y el valor El valor del primer atributo personalizado definido para el producto de API se estableció en 0.1. Cuándo multiplicadas, 125 * 0.1 es 12.5.

    $ curl -H "Content-Type:application/json" -X POST -d \
    '{ 
       "application":{
         "id":"6a9b1afc-2110-43d6-bae7-1b137aecb05b"
       },
       "product":{
         "id":"testproduct"
       },
       "batchSize": 125,
       "custAtt1" : 0.1
    }' \
    "https://api.enterprise.apigee.com/v1/mint/organizations/myOrg/transactions" \
    -u email:password
    
  7. Si a un desarrollador no se le han cobrado las tarifas recurrentes o de configuración necesarias, puedes hacer lo siguiente: Cobra una tarifa de configuración o recurrente por un plan de tarifas mediante el siguiente recurso:
    /organizations/{org_name}/transactions, donde {org_name} es el valor de el nombre de la organización.

    Nota: Si ya se le cobraron al desarrollador tarifas de configuración o tarifas recurrentes, puedes hacer lo siguiente: omitir este paso. Llamar al recurso transactions no afectará la configuración ni tarifas recurrentes definidas por el plan de tarifas.

    La siguiente tabla resume las propiedades de configuración que puedes especificar en el que solicita al cuerpo que cobre manualmente una tarifa de configuración o recurrente de un plan de tarifas, la tarifa predeterminada y si son necesarios o no.

    Propiedad Descripción Predeterminada ¿Obligatorio?
    currency

    Es la moneda que se usa en el plan de tarifas. Especifica el código ISO 4217 para la moneda, como el siguiente: usd para el dólar estadounidense o chf para el franco suizo.

    N/A
    developer

    Es el ID del desarrollador.

    N/A
    rate

    Configuración o tarifa recurrente que se cobrará.

    N/A
    ratePlan

    ID del plan de tarifas.

    N/A
    type

    Establecido en SETUPFEES o RECURRINGFEES.

    CHARGE

    Para omitir los pasos de validación y cobrar la tarifa de manera forzosa, configura la consulta force parámetro en true (por ejemplo, ?force=true). De forma predeterminada, Se ejecutan ?force=false y los pasos de validación. Por ejemplo, si se usa un plan desarrollador tiene un saldo de cero y la actividad de la cuenta se suspende, si ?force=false, la solicitud fallará durante la validación.

    Por ejemplo, la siguiente solicitud cobra una tarifa de configuración de 10 en dólares estadounidenses al desarrollador suscrito al plan de tarifas:

    $ curl -H "Content-Type:application/json" -X POST -d \
    '{ 
       "developer":{
         "id":"dev1@myorg.com"
       },
       "currency":{
         "id":"usd"
       },
       "ratePlan":{
         "id":"mypackage_rateplan1"
       },   
       "rate":10,
       "type":"SETUPFEES"
    }' \
    "https://api.enterprise.apigee.com/v1/mint/organizations/myOrg/transactions" \
    -u email:password