Get the missing requirements of an appInstallation for a specific target app version

GET /v2/app-installations/{appInstallationId}/missing-dependencies/

API version

v2

Request method

GET

Operation ID

app-get-missing-dependencies-for-appinstallation

---

Request

• appInstallationIdstring (uuid)

  required

Responses

Format

application/json

Description

The missing dependencies of the AppInstallation for the target AppVersion.

Schema documentation

• missingSystemSoftwareDependenciesarray of object
  • Array[
  • *object

    A SystemSoftwareDependency is a description of a need for a specific SystemSoftware in a semver versionRange.

    • systemSoftwareIdstring (uuid)

      required
    • versionRangestring

      required
  ]

missingUserInputsarray of object

• Array[
• *object

  A UserInput is a description of an information which cannot be determined or estimated by mittwald, but has to be given by the person who is requesting an AppInstallation or SystemSoftware.

  • dataSourcestring

    Optional field to tell the frontend, which data to put into the select.

  • dataTypestring (one of: text, number, boolean, select)

    required

    UserInputDataType is an enum, describing the possible data types of a UserInput.

  • defaultValuestring
  • formatstring (one of: email, password, url, uri)

    UserInputFormat is an enum, describing the possible data formats of a UserInput, the given values can be validated against.

  • lifecycleConstraintstring (one of: installation, update, reconfigure)

    required

    The AppInstallationLifecycle can be used to express a specific point in the AppInstallation Lifecycle, e.g. while installing a new AppInstallation.

  • namestring

    required
  • positionMetaobject

    UserInputPositionMeta is a utility information, helping to position the UserInput properly on the frontend.

    • indexnumber
    • sectionstring
    • stepstring
  • requiredboolean

    required
  • validationSchemastring

    required

    JSON Schema formatted (https://json-schema.org/).

]

Example

{
  "missingSystemSoftwareDependencies": [
    {
      "systemSoftwareId": "f0f86186-0a5a-45b2-aa33-502777496347",
      "versionRange": "string"
    }
  ],
  "missingUserInputs": [
    {
      "dataSource": "string",
      "dataType": "text",
      "defaultValue": "string",
      "format": "email",
      "lifecycleConstraint": "installation",
      "name": "string",
      "positionMeta": {
        "index": 123,
        "section": "string",
        "step": "string"
      },
      "required": true,
      "validationSchema": "string"
    }
  ]
}

JSON Schema

{
  "properties": {
    "missingSystemSoftwareDependencies": {
      "items": {
        "description": "A SystemSoftwareDependency is a description of a need for a specific SystemSoftware in a semver versionRange.",
        "properties": {
          "systemSoftwareId": {
            "format": "uuid",
            "type": "string"
          },
          "versionRange": {
            "type": "string"
          }
        },
        "required": [
          "systemSoftwareId",
          "versionRange"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "missingUserInputs": {
      "items": {
        "description": "A UserInput is a description of an information which cannot be determined or estimated by mittwald, but has to be given by the person who is requesting an AppInstallation or SystemSoftware.",
        "properties": {
          "dataSource": {
            "description": "Optional field to tell the frontend, which data to put into the select.",
            "type": "string"
          },
          "dataType": {
            "description": "UserInputDataType is an enum, describing the possible data types of a UserInput.",
            "enum": [
              "text",
              "number",
              "boolean",
              "select"
            ],
            "type": "string"
          },
          "defaultValue": {
            "type": "string"
          },
          "format": {
            "description": "UserInputFormat is an enum, describing the possible data formats of a UserInput, the given values can be validated against.",
            "enum": [
              "email",
              "password",
              "url",
              "uri"
            ],
            "type": "string"
          },
          "lifecycleConstraint": {
            "description": "The AppInstallationLifecycle can be used to express a specific point in the AppInstallation Lifecycle, e.g. while installing a new AppInstallation.",
            "enum": [
              "installation",
              "update",
              "reconfigure"
            ],
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "positionMeta": {
            "description": "UserInputPositionMeta is a utility information, helping to position the UserInput properly on the frontend.",
            "properties": {
              "index": {
                "type": "number"
              },
              "section": {
                "type": "string"
              },
              "step": {
                "type": "string"
              }
            },
            "type": "object"
          },
          "required": {
            "type": "boolean"
          },
          "validationSchema": {
            "description": "JSON Schema formatted (https://json-schema.org/).",
            "type": "string"
          }
        },
        "required": [
          "name",
          "dataType",
          "validationSchema",
          "lifecycleConstraint",
          "required"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "type": "object"
}

Usage examples

cURL

$ curl \
    --fail \
    --location \
    -H "Authorization: Bearer $MITTWALD_API_TOKEN" \
    https://api.mittwald.de/v2/app-installations/f0f86186-0a5a-45b2-aa33-502777496347/missing-dependencies?targetAppVersionID=f0f86186-0a5a-45b2-aa33-502777496347

JavaScript SDK

import { MittwaldAPIV2Client } from "@mittwald/api-client";
import { assertStatus } from "@mittwald/api-client-commons";
  
const client = MittwaldAPIClient.newWithToken(process.env.MITTWALD_API_TOKEN);
const response = await client.app.getMissingDependenciesForAppinstallation({
  "appInstallationId": "f0f86186-0a5a-45b2-aa33-502777496347",
  "queryParameters": {
    "targetAppVersionID": "f0f86186-0a5a-45b2-aa33-502777496347"
  }
});

assertStatus(response, 200);
  

PHP SDK

use \Mittwald\ApiClient\Generated\V2\Clients\App\GetMissingDependenciesForAppinstallation\GetMissingDependenciesForAppinstallationRequest;
  
$client = MittwaldAPIClient::newWithToken(getenv('MITTWALD_API_TOKEN'));

$request = (new GetMissingDependenciesForAppinstallationRequest(
  appInstallationId: "f0f86186-0a5a-45b2-aa33-502777496347"
))
  ->withTargetAppVersionID("f0f86186-0a5a-45b2-aa33-502777496347");
$response = $client->app()->getMissingDependenciesForAppinstallation($request);

var_dump($response->getBody();