apiVersion: naftiko.dev/v1
kind: Capability
metadata:
  name: ship24-trackers
  provider: Ship24
  api: Ship24 Tracking API
  description: |
    Create, list, retrieve, update, and bulk-create Trackers — Ship24's
    primary resource representing a parcel being followed across one or more
    couriers.
spec:
  operations:
    - id: create-tracker
      method: POST
      path: /public/v1/trackers
      summary: Create a tracker for a single tracking number with optional courier hint.
    - id: list-trackers
      method: GET
      path: /public/v1/trackers
      summary: List existing trackers, paginated.
    - id: bulk-create-trackers
      method: POST
      path: /public/v1/trackers/bulk
      summary: Create up to N trackers in a single call.
    - id: get-tracker-by-trackerId
      method: GET
      path: /public/v1/trackers/{trackerId}
      summary: Retrieve a tracker by Ship24 tracker ID.
    - id: update-tracker-by-trackerId
      method: PATCH
      path: /public/v1/trackers/{trackerId}
      summary: Update tracker metadata (client tracker ID, destination country, etc.).
  governance:
    auth: bearer_api_key
    rate_limits:
      create-tracker: 10/s
      list-trackers: 10/s
      bulk-create-trackers: 3/s
      get-tracker-by-trackerId: 10/s
      update-tracker-by-trackerId: 10/s
    billable: yes
    billing_metric: shipment