{
  "info": {
    "_postman_id": "78691f51-8fa6-4246-9fba-72bd06f29aeb",
    "name": "Prime Wearables API",
    "description": "OpenAPI contract for Apex Prime v1 endpoints under api.parkerapex.com.\nThis spec covers wearable ingestion, canonical observation writes, device provenance upsert,\nand readiness flag retrieval aligned with the Apex Data Lake integration model.\n",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{access_token}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "base_url",
      "value": "https://api.parkerapex.com/prime/v1",
      "type": "string"
    },
    {
      "key": "access_token",
      "value": "REPLACE_WITH_TOKEN",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "Wearables",
      "item": [
        {
          "name": "Ingest raw vendor telemetry",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/wearables/events",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "wearables",
                "events"
              ]
            },
            "description": "Accept vendor-native telemetry payload and enqueue normalization.",
            "body": {
              "mode": "raw",
              "raw": "{}"
            }
          }
        },
        {
          "name": "Ingest raw vendor telemetry (gateway alias)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/prime/ingest",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "prime",
                "ingest"
              ]
            },
            "description": "Gateway-compatible alias for Prime ingest. This operation maps to the\ncanonical Prime flow at POST /wearables/events.\n",
            "body": {
              "mode": "raw",
              "raw": "{}"
            }
          }
        },
        {
          "name": "Get ingestion status",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/wearables/events/{ingestionId}",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "wearables",
                "events",
                "{ingestionId}"
              ]
            },
            "description": "Check normalization and FHIR persistence status for an ingestion job."
          }
        }
      ]
    },
    {
      "name": "FHIR",
      "item": [
        {
          "name": "Submit pre-normalized Prime observation",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/fhir/Observation",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "fhir",
                "Observation"
              ]
            },
            "description": "Create a FHIR Observation from Prime canonical metric schema.",
            "body": {
              "mode": "raw",
              "raw": "{}"
            }
          }
        },
        {
          "name": "Upsert device provenance",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/fhir/Device/{deviceIdentityHash}",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "fhir",
                "Device",
                "{deviceIdentityHash}"
              ]
            },
            "description": "Ensure every telemetry observation references a known source Device.",
            "body": {
              "mode": "raw",
              "raw": "{}"
            }
          }
        }
      ]
    },
    {
      "name": "Alerts",
      "item": [
        {
          "name": "Retrieve Prime readiness flags",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/fhir/Flag",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "fhir",
                "Flag"
              ]
            },
            "description": "Retrieve readiness alerts represented as FHIR Flag resources."
          }
        }
      ]
    }
  ]
}