Zarządzaj Warunkami korzystania z usługi

Wyświetlasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. info

Wprowadzenie

Zanim opublikujesz plan taryfowy, musisz dodać warunki korzystania z usługi do profilu organizacji. Warunki korzystania z usługi znajdują się poza profilem organizacji. W profilu organizacji określasz lokalizację (publiczny adres URL) warunków korzystania z usługi.

Po opublikowaniu planu taryfowego w portalu dla programistów wyświetla się aktualna wersja warunków korzystania z usługi. Deweloperzy mogą kupić plan tylko po zaakceptowaniu aktualnych warunków korzystania z usługi.

Dodawanie warunków korzystania z usługi za pomocą interfejsu

1. Otwórz stronę Profil organizacji zgodnie z opisem w sekcji Przeglądanie strony Profil organizacji.
2. Kliknij Edytuj.
3. W sekcji Warunki korzystania z usługi na stronie Profil organizacji kliknij Dodaj warunki korzystania z usługi.

   Wyświetli się okno Nowe warunki korzystania z usługi.

4. Podaj te informacje:

   Pole	Opis
   Data wejścia w życie	Data, od której obowiązują warunki korzystania z usługi. Domyślnie jest to bieżąca data. Musisz wpisać bieżącą lub przyszłą datę.
   Wersja	Wersja warunków korzystania z usługi. Numer wersji umożliwia śledzenie różnych wersji warunków korzystania z usługi.
   URL	Adres URL warunków korzystania z usługi.

5. Kliknij Utwórz.

   Nowe warunki korzystania z usługi zostaną dodane do sekcji Warunki korzystania z usługi na stronie Profil organizacji strony.

6. Powtórz kroki od 3 do 5, aby dodać dodatkowe warunki korzystania z usługi.
7. Kliknij Zapisz , aby zapisać zmiany w profilu organizacji.

Edytowanie warunków korzystania z usługi za pomocą interfejsu

Nie możesz bezpośrednio edytować warunków korzystania z usługi. Zamiast tego musisz usunąć warunki korzystania z usługi , które chcesz edytować, a następnie dodać nowy wpis warunków korzystania z usługi.

Usuwanie warunków korzystania z usługi za pomocą interfejsu

1. Otwórz stronę Profil organizacji zgodnie z opisem w sekcji Przeglądanie strony Profil organizacji.
2. Na stronie Profil organizacji kliknij Edytuj.
3. Na liście warunków korzystania z usługi najedź kursorem na warunki korzystania z usługi, które chcesz usunąć.
4. Kliknij .

Zarządzanie warunkami korzystania z usługi za pomocą interfejsu API

Zarządzaj warunkami korzystania z usługi za pomocą interfejsu API zgodnie z opisem w kolejnych sekcjach.

Dodawanie warunków korzystania z usługi za pomocą interfejsu API

Dodaj warunki korzystania z usługi, wysyłając żądanie POST do adresu /mint/organizations/{org_name}/tncs. Podczas dodawania warunków korzystania z usługi możesz opcjonalnie określić:

• URL
• Tekst towarzyszący (np. opis)
• Data, od której obowiązują warunki korzystania z usługi
• Numer wersji

Więcej informacji o tych opcjach znajdziesz w sekcji Właściwości konfiguracji warunków korzystania z usługi.

Na przykład:

curl -X POST   "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/tncs" \
  -H "Content-Type: application/json" \
  -d \
  '{
     "url":"www.testoperator/termsandconditions",
     "tncText":"Sample text for the T&C",
     "version":"1.1",
     "startDate":"2018-09-24"
  }' \
  -u email:password

Oto przykład odpowiedzi:

{
   "id" : "6803d70a-18cc-40c8-b250-675c5e8a75c ",
   "organization" : {     
     …
   },
   "startDate" : "2018-09-24 00:00:00",
   "tncText" : "Sample text for the T&C",
   "url" : "www.testoperator/termsandconditions",
   "version" : "1.1"
 }

Wyświetlanie warunków korzystania z usługi za pomocą interfejsu API

Wyświetl konkretne warunki korzystania z usługi lub wszystkie warunki korzystania z usługi w organizacji.

Aby wyświetlić konkretne warunki korzystania z usługi, wyślij żądanie GET do adresu /mint/organizations/{org_name}/tncs/{tncs_id}, gdzie {tncs_id} to identyfikator konkretnych warunków korzystania z usługi (identyfikator jest zwracany w odpowiedzi podczas tworzenia warunków korzystania z usługi). Na przykład:

curl -X GET "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/tncs/6803d70a-18cc-40c8-b250-675c5e8a75c" \
  -H "Accept: application/json"  \
  -u email:password

Aby wyświetlić wszystkie warunki korzystania z usługi w organizacji, wyślij żądanie GET do adresu /mint/organizations/{org_name}/tncs. Na przykład:

curl -X GET "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/tncs" \
  -H "Accept: application/json" \
  -u email:password

Oto przykład odpowiedzi:

{

"tnc" : [
  {
    "id" : "77193339-8d79-44a8-8af2-3593f16c158e",
    "organization" :
    {
      ...
    },
   "startDate" : "2018-07-01 00:00:00",
   "tncText" : "Big operator text for the T&C",
   "url" : "www.bigoperator/termsandconditions",
   "version" : "1.0"
  },
  {
    "id" : "6803d70a-18cc-40c8-b250-675c5e8a75c3",
    "organization" : {
    ...
  },
    "startDate" : "2018-09-24 00:00:00",
    "tncText" : "Sample text for the T&C",
    "url" : "www.testoperator/termsandconditions",
    "version" : "1.1"
  }
  ]
   "totalRecords" : 2
}

Akceptowanie dokumentu warunków korzystania z usługi przez dewelopera lub firmę za pomocą interfejsu API

Aby zaakceptować dokument warunków korzystania z usługi dla konkretnego dewelopera lub firmy, wyślij żądanie POST do jednego z tych interfejsów API:

• /mint/organizations/{org_name}/developers/{dev_id}/tncs/{tncs_id}/developer-tncs
• /mint/organizations/{org_name}/companies/{company_id}/tncs/{tncs_id}/developer-tncs

Gdzie {dev_id} to identyfikator dewelopera (adres e-mail), {company_id} to identyfikator firmy, a {tncs_id} to identyfikator dokumentu warunków korzystania z usługi.

Na przykład:

curl -X POST "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers/dev2@myorg.com/tncs/5a291b86-42e3-4ae1-8db3-efe4b0877316/developer-tncs" \
  -H "Content-Type: application/json" \
  -d \
  '{
     "action":"ACCEPTED",
     "auditDate":"2018-10-01 00:00:00"
  }' \
  -u email:password

Oto przykład odpowiedzi:

{
  "action": "ACCEPTED",
  "auditDate": "2018-10-01 07:24:45",
  "id": "dev2@myorg.com",
  "tnc": {
      "id": "5a291b86-42e3-4ae1-8db3-efe4b0877316",
      ...
  }
}

Wyświetlanie warunków korzystania z usługi zaakceptowanych przez dewelopera lub firmę za pomocą interfejsu API

Aby wyświetlić warunki korzystania z usługi zaakceptowane przez konkretnego dewelopera lub firmę, wyślij żądanie GET do jednego z tych interfejsów API:

• /mint/organizations/{org_name}/developers/{dev_id}/developer-tncs
• /mint/organizations/{org_name}/companies/{company_id}/developer-tncs

Gdzie {dev_id} to identyfikator dewelopera (adres e-mail), a {company_id} to identyfikator firmy.

Na przykład:

curl -X GET "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers/dev2@myorg.com/developer-tncs" \
  -H "Accept:application/json"  \
  -u email:password

Oto przykład odpowiedzi:

{
  "developerTnc": [
  {
    "action": "ACCEPTED",
    "auditDate": "2018-08-29 07:24:45",
    "id": "dev2@myorg.com",
    "tnc": {
      "id": "26abc14c-c628-4c38-8840-a343c8ee9437",
      ...
    }
  }],
  "totalRecords": 1
}

Edytowanie warunków korzystania z usługi za pomocą interfejsu API

Aby edytować warunki korzystania z usługi, wyślij żądanie PUT do /mint/organizations/{org_named}/tncs/{tncs_id}, gdzie {tncs_id} to identyfikator warunków korzystania z usługi. Podczas aktualizacji musisz określić w treści żądania zaktualizowane ustawienia i identyfikator warunków korzystania z usługi. Na przykład to żądanie edytuje numer wersji warunków korzystania z usługi (zaktualizowana właściwość jest wyróżniona w przykładzie):

curl -X PUT "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/tncs/cfbb03b3-b707-495b-9b8a-ff67d71065a9" \
  -H "Content-Type: application/json" \
  -d {
    "id":"6803d70a-18cc-40c8-b250-675c5e8a75c",
    "version":"1.2"
  }' \
  -u email:password

Oto przykład odpowiedzi:

{
   "id" : "cfbb03b3-b707-495b-9b8a-ff67d71065a9",
   "organization" : {
       "address" : [ {
       "address1" : "Test address",
       "city" : "Test City",
       "country" : "US",
       "id" : "test-address",
       "isPrimary" : true,
       "state" : "CA",
       "zip" : "54321"
     } ],
     …"
   },
   "startDate" : "2018-09-24 00:00:00",
   "tncText" : "Sample text for the T&C",
   "url" : "www.testoperator/termsandconditions",
   "version" : "1.2"
 }

Usuwanie warunków korzystania z usługi za pomocą interfejsu API

Aby usunąć warunki korzystania z usługi, wyślij żądanie DELETE do /mint/organizations/{org_name}/tncs/{tncs_id}, gdzie {tncs_id} to identyfikator warunków korzystania z usługi. Na przykład:

curl -X DELETE "https://api.enterprise.apigee.com/v1/mint/organizations/myorg/tncs/6803d70a-18cc-40c8-b250-675c5e8a75c" \
  -H "Accept: application/json"  \
  -u email:password

Właściwości konfiguracji warunków korzystania z usługi w interfejsie API

W tabeli poniżej znajdziesz podsumowanie właściwości konfiguracji, które można ustawić za pomocą interfejsu API w przypadku warunków korzystania z usługi.

Dalsze kroki

Dowiedz się, jak dodać obsługiwane waluty do tych, które zostały początkowo skonfigurowane w Twojej organizacji, w sekcji Zarządzanie obsługiwanymi walutami.