Skip to main content

Kontrolle+ Provider Integration Hub

This page centralizes provider onboarding guidance and API reference in one place.

What You Can Do Here​

  • Understand authentication requirements.
  • Submit control batches asynchronously.
  • Track job progress and per-item results.
  • Open a dedicated ReDoc API reference page.

Quickstart​

  1. Get a token → Token Acquisition Guide · INT Test Credentials
  2. Send POST /api/provider/v1/controls with controls[] — Full Quickstart
  3. Read job_id from the 202 Accepted response.
  4. Poll GET /api/provider/v1/jobs/{job_id} for aggregate status.
  5. Use GET /api/provider/v1/jobs/{job_id}/items for item-level outcomes.

Runtime Endpoints​

  • Local base URL: http://localhost:3002
  • INT base URL: https://kontrolleplus-dev-data.orangeglacier-1536cc06.switzerlandnorth.azurecontainerapps.io
  • Live Swagger UI (INT): Open Swagger

API Reference (ReDoc)​

OpenAPI Source and Sync​

This portal uses the OpenAPI source from the main backend repository:

  • Source file: ../openapi/provider-controls.openapi.yaml
  • Synced target: static/openapi/provider-controls.openapi.yaml
  • Sync command: npm run sync:openapi

npm run start and npm run build sync the spec automatically.