apiVersion: naftiko.dev/v1
kind: Capability
metadata:
  name: ship24-tracking-results
  provider: Ship24
  api: Ship24 Tracking API
  description: |
    Retrieve normalized tracking event timelines for trackers — either by
    tracker ID, by tracking number, or as a one-shot "create + return results"
    operation.
spec:
  operations:
    - id: create-tracker-and-get-tracking-results
      method: POST
      path: /public/v1/trackers/track
      summary: Create a tracker and synchronously return the latest tracking results.
    - id: get-tracking-results-of-tracker-by-trackerId
      method: GET
      path: /public/v1/trackers/{trackerId}/results
      summary: Get tracking results for a tracker by tracker ID.
    - id: get-tracking-results-of-trackers-by-tracking-number
      method: GET
      path: /public/v1/trackers/search/{trackingNumber}/results
      summary: Get tracking results across trackers by raw tracking number.
    - id: get-tracking
      method: POST
      path: /public/v1/tracking/search
      summary: Search tracking results by tracking number, courier, or filters.
  governance:
    auth: bearer_api_key
    rate_limits: 10/s
    billable: yes
    billing_metric: shipment