Find a vessel and read its position and recent track

# authorship: generated by API Evangelist tooling. Stamped 2026-08-18
# on the file's own generator header (roadmap#64). An unmarked file is
# NOT assumed to be ours -- absence of evidence was never stamped.
x-method: generated
arazzo: 1.0.1
info:
  title: Find a vessel and read its position and recent track
  version: 1.0.0
  description: Native Arazzo workflow over the ShipFinder Global Maritime Data API. Generated by API Evangelist on 2026-08-09; every operationId is verified against openapi/shipfinder-ais-data-api-openapi.yml.
sourceDescriptions:
- name: aisDatasetApi
  url: ../openapi/shipfinder-ais-data-api-ais-dataset-api-openapi.yml
  type: openapi
- name: historyDatasetApi
  url: ../openapi/shipfinder-ais-data-api-history-dataset-api-openapi.yml
  type: openapi
workflows:
- workflowId: trackAVessel
  summary: Find a vessel and read its position and recent track
  inputs:
    type: object
    required:
    - apiKey
    - vesselName
    - startTime
    - endTime
    properties:
      apiKey:
        type: string
        description: ShipFinder API key
      vesselName:
        type: string
        description: Vessel name, call sign, MMSI or IMO
      startTime:
        type: string
        description: Track window start
      endTime:
        type: string
        description: Track window end
  steps:
  - stepId: searchVessel
    operationId: getVesselSearch
    parameters:
    - name: key
      in: query
      value: $inputs.apiKey
    - name: keywords
      in: query
      value: $inputs.vesselName
    successCriteria:
    - condition: $statusCode == 200
    - context: $response.body
      condition: $.status == 0
      type: jsonpath
    outputs:
      mmsi: $response.body#/data/0/mmsi
  - stepId: currentPosition
    operationId: getVesselPositionSingle
    parameters:
    - name: key
      in: query
      value: $inputs.apiKey
    - name: mmsi
      in: query
      value: $steps.searchVessel.outputs.mmsi
    successCriteria:
    - condition: $statusCode == 200
    - context: $response.body
      condition: $.status == 0
      type: jsonpath
    outputs:
      position: $response.body#/data
  - stepId: historyTrack
    operationId: getVesselHistoryTrack
    parameters:
    - name: key
      in: query
      value: $inputs.apiKey
    - name: mmsi
      in: query
      value: $steps.searchVessel.outputs.mmsi
    - name: start_time
      in: query
      value: $inputs.startTime
    - name: end_time
      in: query
      value: $inputs.endTime
    successCriteria:
    - condition: $statusCode == 200
    - context: $response.body
      condition: $.status == 0
      type: jsonpath
    outputs:
      track: $response.body#/data
  outputs:
    track: $steps.historyTrack.outputs.track