Onboard a vehicle and its tire sensors

arazzo: 1.0.1
info:
  title: Onboard a vehicle and its tire sensors
  version: 1.0.0
  summary: Authenticate, create a vehicle, register its gateway and sensors, then verify.
  x-realizes-capability-ids:
  - BC-2430
  - BC-2430.40
  x-capability-derivation:
    method: 'deterministic join: sourceDescriptions -> per-tag OpenAPI -> tag/capability edge. No classification at this step.'
    min_confidence: 0.7
    sources:
    - capability_id: BC-2430
      capability_name: Fleet & Mobile Asset Management
      spec: revvo-vehicle-api-openapi.yml
      confidence: 0.75
    - capability_id: BC-2430.40
      capability_name: Fleet Telematics and Monitoring
      spec: revvo-device-api-openapi.yml
      confidence: 0.82
    model: Turbo EA Capabilities by Vincent Verdet — Turbo EA, https://github.com/vincentmakes/turbo-ea-capabilities, CC BY 4.0
sourceDescriptions:
- name: authApi
  url: ../openapi/revvo-auth-api-openapi.yml
  type: openapi
- name: deviceApi
  url: ../openapi/revvo-device-api-openapi.yml
  type: openapi
- name: vehicleApi
  url: ../openapi/revvo-vehicle-api-openapi.yml
  type: openapi
workflows:
- workflowId: onboardVehicle
  summary: Create a vehicle in a fleet and attach its tire-monitoring hardware.
  inputs:
    type: object
    properties:
      apiKey: {type: string}
      fleetId: {type: string}
      vin: {type: string}
      assetId: {type: string}
      template: {type: string}
      gatewayMacAddress: {type: string}
      gatewayInstallLocation: {type: string}
  steps:
  - stepId: authenticate
    operationId: authToken
    parameters:
    - name: X-API-KEY
      in: header
      value: $inputs.apiKey
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      token: $response.body
  - stepId: createVehicle
    operationId: vehicle
    parameters:
    - name: fleetId
      in: path
      value: $inputs.fleetId
    requestBody:
      contentType: application/json
      payload:
        vin: $inputs.vin
        assetId: $inputs.assetId
        template: $inputs.template
    successCriteria:
    - condition: $statusCode == 201
  - stepId: registerDevices
    operationId: registerDevicesForVehicle
    parameters:
    - name: fleetId
      in: path
      value: $inputs.fleetId
    requestBody:
      contentType: application/json
      payload:
        assetId: $inputs.assetId
        gatewayMacAddress: $inputs.gatewayMacAddress
        gatewayInstallLocation: $inputs.gatewayInstallLocation
    successCriteria:
    - condition: $statusCode == 200
  - stepId: verifyVehicle
    operationId: getVehicle
    parameters:
    - name: fleetId
      in: path
      value: $inputs.fleetId
    - name: vin
      in: path
      value: $inputs.vin
    successCriteria:
    - condition: $statusCode == 200