Integracje sprzężenia zwrotnego potoku

Interfejs API wersji produktu

Nasza Interfejs API wydań udostępnia punkty końcowe do tworzenia, odczytywania, aktualizowania i usuwania wersji. Znaczniki wersji mogą być tworzone z czterema różnymi zasięgami:

• Globalne
• Perspektywa aplikacji
• Usługi
• Usługa w perspektywie aplikacji

W poniższym przykładzie komenda curl jest używana do utworzenia nowego globalnego znacznika wydania o nazwie Moje pierwsze wydanie globalne w danym momencie (jako znacznik czasu UNIX w milisekundach):

curl --location --request POST "{{base}}/api/releases" \
  --header "Authorization: apiToken {{apiToken}}" \
  --header "Content-Type: application/json" \
  --data "{
	\"name\": \"My First Global Release\",
	\"start\": 1601890420046,
}"

Uwaga: Wartość "start" musi być datownikiem (w milisekundach).

Ten znacznik wersji jest wyświetlany na wszystkich stronach panelu kontrolnego dla aplikacji, usług i punktów końcowych.

Aby utworzyć znacznik wydania na podstawie istniejącej perspektywy aplikacji, należy dodać applications z listą nazw aplikacji do treści żądania.

curl --location --request POST "{{base}}/api/releases" \
  --header "Authorization: apiToken {{apiToken}}" \
  --header "Content-Type: application/json" \
  --data "{
	\"name\": \"My First Application Scoped Release\",
	\"start\": 1601890420046,
	\"applications\": [
      {
        \"name\": \"My Application\" 
      }
    ]
}"

Ten znacznik wersji jest wyświetlany na panelu kontrolnym dla aplikacji Moja aplikacja.

Poniższy fragment kodu pokazuje, w jaki sposób utworzyć znacznik wydania dla danej usługi.

curl --location --request POST "{{base}}/api/releases" \
  --header "Authorization: apiToken {{apiToken}}" \
  --header "Content-Type: application/json" \
  --data "{
	\"name\": \"My First Service Scoped Release\",
	\"start\": 1601890420046,
	\"services\": [
      {
        \"name\": "\"my-service\"
      }
    ]
}"

Ten znacznik wydania o zasięgu usługi jest wyświetlany na panelach kontrolnych dla usługi moja-usługa i wszystkich panelach kontrolnych aplikacji, które zawierają usługę moja-usługa. Dla danego zestawu aplikacji można także utworzyć znacznik wydania o zasięgu usługi.

curl --location --request POST "{{base}}/api/releases" \
  --header "Authorization: apiToken {{apiToken}}" \
  --header "Content-Type: application/json" \
  --data "{
	\"name\": \"My First Service Scoped Release\",
	\"start\": 1601890420046,
	\"services\": [
      {
        \"name\": \"my-service\",
        \"scopedTo\": {
          \"applications\": [
            {
              \"name\": \"My Application\"
            }
          ]
        }
      }
    ]
}"

Podany znacznik wersji zostanie wyświetlony tylko dla usługi moja-usługa w ramach danej aplikacji Moja aplikacja, ale nie dla innych usług w aplikacji.

Notatka: Do użycia Znacznik interfejsu API wymagane jest uprawnienie "Konfiguracja wydań".

Integracje produktu