From c4748e2a4f8f16ba04365d461ac9b9675fb8d76b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Priit=20P=C3=A4rna?= Date: Tue, 10 Nov 2026 11:24:57 +0200 Subject: [PATCH] docs: publish Deadlines API reference Add the Switching Deadlines API to the Redoc spec list at /api/deadlines and regenerate the API discovery document. The spec is published to docs.api.epilot.io/deadlines.yaml by deadlines-api's post-deploy step, but no docs entry existed, so /api/deadlines returned 404. Point the Switching Deadlines intro at the new reference (it linked to the Pricing API) and drop the link to @epilot/deadlines-client, which is not published. Co-Authored-By: Claude Opus 5.5 --- docs/deadlines/intro.md | 6 +++--- redoc.config.js | 5 +++++ static/openapi-specs/apis.json | 10 ++++++++++ 3 files changed, 18 insertions(+), 3 deletions(-) diff --git a/docs/deadlines/intro.md b/docs/deadlines/intro.md index 5c4e7f2a..ea31bff6 100644 --- a/docs/deadlines/intro.md +++ b/docs/deadlines/intro.md @@ -1,16 +1,16 @@ --- title: Switching Deadlines sidebar_position: 0 -description: "Calculate contract switching deadlines for power and gas in the German energy market, based on regulatory rules, working days and holidays, via API, SDK or a standalone library." +description: "Calculate contract switching deadlines for power and gas in the German energy market, based on regulatory rules, working days and holidays, via API or a standalone library." --- # Contract Switching Deadlines -[[API Docs](/api/pricing)] [[SDK](https://www.npmjs.com/package/@epilot/deadlines-client)] [[Standalone Library](https://www.npmjs.com/package/@epilot/switching-deadlines)] +[[API Docs](/api/deadlines)] [[Standalone Library](https://www.npmjs.com/package/@epilot/switching-deadlines)] German energy market regulations impose strict deadlines for power and gas contract switching. Since June 2025, power contracts without minimum terms can switch within 24 hours. Gas switching takes 10-13 working days, with retrospective switches possible within six weeks for relocation and new registration scenarios. epilot provides two ways to calculate and validate these deadlines: -- **Switching Deadlines API** -- a [REST API](/api/pricing) that calculates and validates supplier switching deadlines for power and gas. +- **Switching Deadlines API** -- a [REST API](/api/deadlines) that calculates and validates supplier switching deadlines for power and gas. - **Open-source library** -- the [Switching Deadlines library](https://github.com/epilot-dev/switching-deadlines) for Node.js. This library powers the API and is freely available. See the [library documentation](/docs/deadlines/deadlines-library/) for usage. diff --git a/redoc.config.js b/redoc.config.js index 8ecfbc77..a763706c 100644 --- a/redoc.config.js +++ b/redoc.config.js @@ -241,4 +241,9 @@ module.exports.specs = [ routePath: '/api/data-governance', specUrl: 'https://docs.api.epilot.io/data-governance.yaml', }, + { + layout: { title: 'Deadlines API' }, + routePath: '/api/deadlines', + specUrl: 'https://docs.api.epilot.io/deadlines.yaml', + }, ]; diff --git a/static/openapi-specs/apis.json b/static/openapi-specs/apis.json index 1e844be5..c8905b7b 100644 --- a/static/openapi-specs/apis.json +++ b/static/openapi-specs/apis.json @@ -482,6 +482,16 @@ "url": "https://docs.api.epilot.io/data-governance.yaml" } ] + }, + { + "name": "Deadlines API", + "baseURL": "https://deadlines-api.sls.epilot.io", + "properties": [ + { + "type": "Swagger", + "url": "https://docs.api.epilot.io/deadlines.yaml" + } + ] } ] }