Określanie szczegółów abonamentu tylko z opłatami

Przeglądasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. Informacje

Wstęp

W przypadku abonamentu z opłatami deweloper płaci tylko opłaty dla dostawcy interfejsu API określone w planie taryfowym, takie jak jednorazowa opłata konfiguracyjna lub opłata za przedterminowe rozwiązanie umowy. Informacje o tym, jak określać opłaty w planie stawek, znajdziesz w sekcji Dodawanie opłat do planu stawek. Nie pobieramy żadnych dodatkowych opłat związanych z transakcjami.

Podczas tworzenia abonamentu możesz opcjonalnie określić okresy odnowienia, czyli okres odnowienia. Funkcja zarabiania automatycznie odnawia abonament na koniec okresu odnowienia (chyba że deweloper go zakończy). Jeśli deweloper zakończy abonament przed upływem okresu odnowienia i zacznie obowiązywać opłata za przedterminowe wypowiedzenie, zostanie ona naliczona.

Zestaw narzędzi

Szczegóły abonamentu dodajesz tylko za pomocą interfejsu Monetization API. Aby to zrobić, ustaw odpowiednie właściwości w treści żądania w wywołaniu zasobu /organizations/{org_name}/monetization-packages/{package_id}/rate-plans (podczas tworzenia abonamentu).

Określanie opłat tylko za pomocą interfejsu API

Podczas tworzenia planu stawek określasz tylko opłaty. Szczegóły określasz w treści żądania wywołania.

Poniższy przykład ilustruje utworzenie planu cenowego tylko z opłatami. Abonament określa opłatę za wcześniejsze zakończenie (20 USD), opłatę konfiguracyjną (10 USD) i opłatę cykliczną (5 USD miesięcznie). Opłaty należy uiścić w ciągu 30 dni, a opłata cykliczna należy w całości (czyli nie jest naliczana proporcjonalnie). Okres odnowienia wynosi 6 miesięcy. (wyróżnione są specyfikacje opłat i okresu odnowienia).

$ curl -H "Content-Type:application/json" -X POST -d \
'{
     "name": "Standard fees only plan",
     "advance": "false",
     "contractDuration": "6",
     "contractDurationType": "MONTH",
      "currency": {
      "id" : "usd"
     },
     "earlyTerminationFee": "20",
     "description": "Standard fees only plan",
     "displayName": "Standard fees only plan",
     "frequencyDuration": 1,
     "frequencyDurationType": "MONTH",
     "monetizationPackage": {
      "id": "location"
     },
     "organization": {
      "id": "{org_name}"
     },
     "prorate": "false",
     "paymentDueDays": "30",
     "published": "true",  
     "ratePlanDetails": [],   
     "recurringFee": "5",
     "setUpFee": "10",
     "startDate": "2013-09-15 00:00:00",
     "type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location/rate-plans"  \
-u email:password

Zwróć uwagę, że właściwość ratePlanDetails jest pusta. W przypadku abonamentu ze stawkami płatnymi nie trzeba podawać dodatkowych informacji poza opłatami i okresem odnowienia.

Odpowiedź powinna wyglądać tak (widoczna jest tylko część odpowiedzi):

{
  "advance" : false,
  "contractDuration" : 6,
  "contractDurationType" : "MONTH",
  "currency" : {    
    "id" : "usd",
    "name" : "USD",
    ...
    "organization" : {
      ...
    },
    ...
  },
  "description" : "Standard fees only plan",
  "displayName" : "Standard fees only plan",
  "earlyTerminationFee" : 20,
  "freemiumDuration" : 0,
  "freemiumDurationType" : "MONTH",
  "freemiumUnit" : 0,
  "frequencyDuration" : 1,
  "frequencyDurationType" : "MONTH",
  "id" : "location_standard_fees_only_plan",
  "monetizationPackage" : {
    "description" : "Location",
    "displayName" : "Location",
    "id" : "location",
    "name" : "Location",
    "organization" : {
      ...
    },
    "product" : [ {
      "customAtt1Name" : "user",
      "description" : "Location",
      "displayName" : "Location",
      "id" : "location",
      "name" : "location",
      "organization" : {
        ...
    "status" : "CREATED"
  },
  "name" : "Standard fees only plan",
  "organization" : {
    ...
  },
  "paymentDueDays" : "30",
  "prorate" : false,
  "published" : false,
  "ratePlanDetails" : [ ],
  "recurringFee" : 5,
  "recurringStartUnit" : 1,
  "recurringType" : "CALENDAR",
  "setUpFee" : 10,
  "startDate" : "2013-07-30 00:00:00",
  "type" : "STANDARD"
}

Pełną listę opcji planu stawek znajdziesz w sekcji Ustawienia konfiguracji planu stawek.

Dalsze kroki

Opcjonalnie możesz dodać abonament freemium. Zobacz Dodawanie abonamentu freemium.

Po utworzeniu planu stawek i podaniu jego szczegółów możesz go opublikować lub zapisać jako wersję roboczą. Więcej informacji znajdziesz w artykule Zarządzanie abonamentami i ich publikowanie.