Entwickler zur Monetarisierung migrieren

<ph type="x-smartling-placeholder"></ph> Sie sehen die Dokumentation zu Apigee Edge.
Gehen Sie zur Apigee X-Dokumentation.
Weitere Informationen

Wenn Sie bereits Entwickler haben, die Sie zur Monetarisierung migrieren müssen, gehen Sie so vor:

  1. Erstellen Sie die API-Produkte, API-Pakete und Tarifpläne für Ihre Entwickler. wenn sie noch nicht vorhanden sind. Weitere Informationen finden Sie unter: <ph type="x-smartling-placeholder">
  2. Veröffentlichen Sie die Preispläne wie unter Preispläne veröffentlichen beschrieben.
  3. Fügen Sie die neuen Entwickler zu Ihrer Organisation hinzu, wie unter App-Entwickler registrieren beschrieben.
  4. Laden Sie das Prepaid-Guthaben für jeden Entwickler auf, wie unter Prepaidkonto verwalten“ beschrieben. Kontostände.
  5. Akzeptieren Sie den Preisplan, wie unter Kaufrate beschrieben. Pläne mithilfe der API erstellen.

    Hinweis: Wenn einem Entwickler bereits Kosten in Rechnung gestellt wurden, können Sie auf die Einrichtungsgebühren verzichten. waivefees auf true setzen.

  6. Wenn ein Entwickler, den Sie migrieren, Transaktionen hat, können Sie die Transaktionsnutzung manuell mit der folgenden Ressource übertragen:
    /organizations/{org_name}/transactions, wobei {org_name} der Wert Name der Organisation.

    Hinweis:Wenn ein Entwickler keine Transaktionen hat, kannst du diesen Schritt überspringen. Schritt.

    Die Ressource transactions fügt eine einzelne Transaktion ein, die den aktuelle Transaktionsnutzung und aktualisiert alle internen Zähler entsprechend.

    Beispiel: Wenn der Entwickler vor der Migration 1.000 Aufrufe an die API gesendet hat, die aktuelle Aktivität zu erfassen. Sie können die Transaktionsnutzung auf 1000 festlegen, indem Sie die transactions-Ressource und Festlegen des Attributs batchSize auf 1.000 den Anfragetext.

    In der folgenden Tabelle sind die Konfigurationseigenschaften zusammengefasst, die Sie in den -Anfragetext, um die Anzahl der Transaktionen, ihre Standardwerte und nicht unbedingt erforderlich.

    Attribut Beschreibung Standard Erforderlich?
    application

    ID der Entwickler-App.

    Ja
    batchSize

    Anzahl der Transaktionen, die Sie übertragen möchten.

    1 Nein
    custAttn

    Wert des benutzerdefinierten Attributs, das mit BatchSize zur Berechnung von Transaktionsnutzung.

    Die benutzerdefinierte Attributnummer in der Nachricht muss als positive Ganzzahl angegeben werden. oder Dezimalwert mit bis zu vier Dezimalstellen. Negative Werte sind nicht zulässig.

    Das benutzerdefinierte Attribut muss definiert werden in:

    Ja
    product

    ID des API-Produkts.

    Ja
    type

    Muss auf CHARGE (Standardeinstellung) festgelegt sein.

    CHARGE Nein

    Um Validierungsschritte zu überspringen und das Festlegen der Anzahl der Transaktionen zu erzwingen, legen Sie den Parameter force-Abfrageparameter für true, z. B. ?force=true. Standardmäßig sind ?force=false und Validierungsschritte ausgeführt haben. Beispiel: Ein Prepaid-Entwickler hat kein Guthaben und keine Aktivitäten auf dem Konto. wird gesperrt, wenn ?force=false die Anfrage während der Validierung fehlschlägt.

    Die folgende Anfrage legt beispielsweise die Anzahl der Transaktionen für die angegebene Anwendung und API-Produkt:

    $ 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
    

    Die folgende Anfrage legt die Transaktionsnutzung für die angegebene Anwendung und auf 12,5 fest. API-Produkts. In der Anfrage wird batchSize auf 125 festgelegt und der Wert für das erste benutzerdefinierte Attribut, das für das API-Produkt definiert ist, auf 0.1 festgelegt ist. Wann? multipliziert werden: 125 * 0,1 ist 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. Wenn einem Entwickler nicht die erforderlichen Einrichtungsgebühren oder wiederkehrenden Gebühren in Rechnung gestellt wurden, können Sie das manuell tun stellen Sie über die folgende Ressource eine Einrichtungsgebühr oder wiederkehrende Gebühr für einen Preisplan in Rechnung:
    /organizations/{org_name}/transactions, wobei {org_name} der Wert Name der Organisation.

    Hinweis:Wenn dem Entwickler bereits Einrichtungsgebühren oder wiederkehrende Gebühren in Rechnung gestellt wurden, können Sie können Sie diesen Schritt überspringen. Das Aufrufen der Ressource transactions hat keinen Einfluss auf die Einrichtung oder wiederkehrende Gebühren, die durch den Preisplan definiert sind.

    In der folgenden Tabelle sind die Konfigurationseigenschaften zusammengefasst, die Sie in den Textkörper anfordern, um manuell eine Einrichtungsgebühr oder wiederkehrende Gebühren für einen Preisplan (Standardeinstellung) in Rechnung zu stellen und ob diese erforderlich sind.

    Attribut Beschreibung Standard Erforderlich?
    currency

    Für den Preisplan verwendete Währung. Geben Sie den ISO 4217-Code für die Währung an, z. B. usd für US-Dollar oder chf für Schweizer Franken.

    Ja
    developer

    ID des Entwicklers.

    Ja
    rate

    Einrichtungsgebühr oder wiederkehrende Gebühr.

    Ja
    ratePlan

    ID des Tarifpakets.

    Ja
    type

    Lege dafür SETUPFEES oder RECURRINGFEES fest.

    CHARGE Ja

    Wenn Sie Validierungsschritte überspringen und die Gebühren erzwingen möchten, legen Sie die Abfrage force fest Parameter auf true setzen (z. B. ?force=true). Standardmäßig ?force=false und Validierungsschritte werden ausgeführt. Wenn z. B. eine vorausbezahlte hat der Entwickler einen Saldo von null und das Konto wird gesperrt, ?force=false schlägt die Anfrage während der Validierung fehl.

    Durch die folgende Anfrage wird beispielsweise eine Einrichtungsgebühr von 10 $ in US-Dollar Entwickler, der den Preisplan abonniert hat:

    $ 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