Improve API documentation and add spec download

src/i18n/locales/de/translation.json

@@ -1008,6 +1008,92 @@
       "issueResolved": "Problem gelöst"
     }
   },
+  "apiDocsPage": {
+    "title": "Eryxon Flow API",
+    "description": "Produktions-Workflow-Management-API für Blechfertigung. Erstellen Sie Integrationen, automatisieren Sie Workflows und verwalten Sie Ihre Produktionsdaten programmgesteuert.",
+    "version": "v1.0.0",
+    "restApi": "REST API",
+    "restApiDesc": "JSON-basierte RESTful API",
+    "apiKeyAuth": "API-Schlüssel-Auth",
+    "apiKeyAuthDesc": "Sichere Bearer-Token-Authentifizierung",
+    "interactiveDocs": "Interaktive Dokumentation",
+    "interactiveDocsDesc": "Endpunkte direkt im Browser testen",
+    "openApiSpec": "OpenAPI-Spezifikation",
+    "openApiSpecDesc": "Laden Sie die Spezifikation herunter für Swagger, Postman oder zur SDK-Generierung",
+    "downloadJson": "JSON herunterladen",
+    "downloadJsonDesc": "OpenAPI 3.0 Spezifikation",
+    "downloadYaml": "YAML herunterladen",
+    "downloadYamlDesc": "Menschenlesbares Format",
+    "swaggerEditor": "Swagger Editor",
+    "swaggerEditorDesc": "Online bearbeiten & validieren",
+    "copySpecUrl": "Spec-URL kopieren",
+    "copySpecUrlDesc": "Direkter Link zum JSON",
+    "importToPostman": "In Postman importieren",
+    "importToPostmanDesc": "Postman öffnen → Import → Link → Einfügen:",
+    "copyUrl": "URL kopieren",
+    "csvImportWizard": "CSV-Import-Assistent",
+    "helpAndGuides": "Hilfe & Anleitungen",
+    "quickStart": "Schnellstart",
+    "codeExamples": "Code-Beispiele",
+    "tryItOut": "Ausprobieren",
+    "fullReference": "Vollständige Referenz",
+    "gettingStarted": "In 3 Schritten starten",
+    "gettingStartedDesc": "Starten Sie in wenigen Minuten mit API-Aufrufen",
+    "step1Title": "API-Schlüssel generieren",
+    "step1Desc": "Navigieren Sie zu <strong>Admin > API-Schlüssel</strong> in der Weboberfläche und generieren Sie einen neuen API-Schlüssel.",
+    "step1KeyPrefix": "Ihr Schlüssel beginnt mit",
+    "keepApiKeySecure": "Halten Sie Ihren API-Schlüssel sicher!",
+    "keepApiKeySecureDesc": "Ihr API-Schlüssel wird nur einmal angezeigt. Speichern Sie ihn sicher und committen Sie ihn niemals in die Versionskontrolle.",
+    "goToApiKeys": "Zu API-Schlüssel",
+    "step2Title": "Verbindung testen",
+    "step2Desc": "Führen Sie Ihren ersten API-Aufruf durch, um zu überprüfen, ob Ihr Schlüssel funktioniert. Wir empfehlen, mit dem schreibgeschützten Endpunkt zu beginnen",
+    "step2Endpoint": "/api-stages",
+    "step2EndpointDesc": "",
+    "baseUrl": "Basis-URL",
+    "curlExample": "cURL-Beispiel",
+    "expectedResponse": "Erwartete Antwort",
+    "step3Title": "Mit dem Entwickeln beginnen",
+    "step3Desc": "Erkunden Sie die API-Referenz unten, um alle verfügbaren Endpunkte zu sehen und sie interaktiv zu testen.",
+    "commonUseCases": "Häufige Anwendungsfälle",
+    "useCase1": "Aufträge aus ERP-Systemen erstellen",
+    "useCase2": "Produktionsfortschritt verfolgen",
+    "useCase3": "Aufgabenabschluss aktualisieren",
+    "useCase4": "Auftragsstatus und Metriken abfragen",
+    "bestPractices": "Best Practices",
+    "practice1": "Paginierung für große Datensätze verwenden",
+    "practice2": "Exponentiellen Backoff implementieren",
+    "practice3": "Rate-Limit-Header behandeln",
+    "practice4": "Antworten validieren",
+    "codeExamplesTitle": "Code-Beispiele",
+    "codeExamplesDesc": "Sofort einsetzbare Code-Snippets in mehreren Programmiersprachen",
+    "authentication": "Authentifizierung",
+    "authDesc": "Alle API-Anfragen erfordern Authentifizierung mit einem API-Schlüssel im Authorization-Header:",
+    "headerFormat": "Header-Format",
+    "rateLimiting": "Rate-Limiting",
+    "rateLimitingDesc": "API-Anfragen sind begrenzt. Prüfen Sie die X-RateLimit-* Header in den Antworten für aktuelle Limits und Nutzung.",
+    "interactiveTesting": "Interaktive API-Tests",
+    "interactiveTestingDesc": "Testen Sie API-Endpunkte direkt in Ihrem Browser. Keine zusätzlichen Tools erforderlich!",
+    "howToTest": "So testen Sie",
+    "howToTestStep1": "Klicken Sie auf die Schaltfläche \"Autorisieren\" unten (grünes Schloss-Symbol)",
+    "howToTestStep2": "Geben Sie Ihren API-Schlüssel ein:",
+    "howToTestStep3": "Erweitern Sie einen Endpunkt und klicken Sie auf \"Ausprobieren\"",
+    "howToTestStep4": "Füllen Sie die Parameter aus und klicken Sie auf \"Ausführen\"",
+    "quickTestEndpoints": "Schnelltest-Endpunkte",
+    "stagesEndpointDesc": "Bester Endpunkt zum Testen Ihres API-Schlüssels. Gibt alle Produktionsstufen zurück.",
+    "jobsGetEndpointDesc": "Alle Aufträge mit Filterung auflisten. Paginierung mit limit/offset testen.",
+    "jobsPostEndpointDesc": "Einen neuen Auftrag erstellen. Enthält Beispiel-Request-Body.",
+    "jobsSyncEndpointDesc": "ERP-Sync-Endpunkt. Upsert nach external_id.",
+    "completeApiReference": "Vollständige API-Referenz",
+    "completeApiReferenceDesc": "Vollständige OpenAPI-Spezifikation mit allen Endpunkten, Schemas und Beispielen.",
+    "openInSwaggerEditor": "In Swagger Editor öffnen",
+    "downloaded": "Heruntergeladen!",
+    "downloadedDesc": "OpenAPI-Spezifikation als {{filename}} heruntergeladen",
+    "downloadError": "Spezifikation konnte nicht heruntergeladen werden",
+    "copied": "Kopiert!",
+    "copiedDesc": "{{label}} in Zwischenablage kopiert",
+    "specUrl": "Spec-URL",
+    "postmanImportUrl": "Postman-Import-URL"
+  },
   "dataExport": {
     "title": "Datenexport",
     "chooseEntities": "Entitäten auswählen",

src/i18n/locales/en/translation.json

@@ -1140,9 +1140,99 @@
       "issueResolved": "Issue Resolved"
     }
   },
+  "apiDocsPage": {
+    "title": "Eryxon Flow API",
+    "description": "Production workflow management API for sheet metal manufacturing. Build integrations, automate workflows, and manage your production data programmatically.",
+    "version": "v1.0.0",
+    "restApi": "REST API",
+    "restApiDesc": "JSON-based RESTful API",
+    "apiKeyAuth": "API Key Auth",
+    "apiKeyAuthDesc": "Secure bearer token authentication",
+    "interactiveDocs": "Interactive Docs",
+    "interactiveDocsDesc": "Test endpoints directly in browser",
+    "openApiSpec": "OpenAPI Specification",
+    "openApiSpecDesc": "Download the spec to use with Swagger, Postman, or generate client SDKs",
+    "downloadJson": "Download JSON",
+    "downloadJsonDesc": "OpenAPI 3.0 spec",
+    "downloadYaml": "Download YAML",
+    "downloadYamlDesc": "Human-readable format",
+    "swaggerEditor": "Swagger Editor",
+    "swaggerEditorDesc": "Edit & validate online",
+    "copySpecUrl": "Copy Spec URL",
+    "copySpecUrlDesc": "Direct link to JSON",
+    "importToPostman": "Import to Postman",
+    "importToPostmanDesc": "Open Postman → Import → Link → Paste:",
+    "copyUrl": "Copy URL",
+    "csvImportWizard": "CSV Import Wizard",
+    "helpAndGuides": "Help & Guides",
+    "quickStart": "Quick Start",
+    "codeExamples": "Code Examples",
+    "tryItOut": "Try It Out",
+    "fullReference": "Full Reference",
+    "gettingStarted": "Getting Started in 3 Steps",
+    "gettingStartedDesc": "Start making API calls in minutes with this beginner-friendly guide",
+    "step1Title": "Generate an API Key",
+    "step1Desc": "Navigate to <strong>Admin > API Keys</strong> in the web interface and generate a new API key.",
+    "step1KeyPrefix": "Your key will start with",
+    "keepApiKeySecure": "Keep your API key secure!",
+    "keepApiKeySecureDesc": "Your API key is shown only once. Store it securely and never commit it to version control.",
+    "goToApiKeys": "Go to API Keys",
+    "step2Title": "Test Your Connection",
+    "step2Desc": "Make your first API call to verify your key works. We recommend starting with the read-only",
+    "step2Endpoint": "/api-stages",
+    "step2EndpointDesc": "endpoint.",
+    "baseUrl": "Base URL",
+    "curlExample": "cURL Example",
+    "expectedResponse": "Expected Response",
+    "step3Title": "Start Building",
+    "step3Desc": "Explore the API Reference below to see all available endpoints and try them interactively.",
+    "commonUseCases": "Common Use Cases",
+    "useCase1": "Create jobs from ERP systems",
+    "useCase2": "Track production progress",
+    "useCase3": "Update task completion",
+    "useCase4": "Query job status and metrics",
+    "bestPractices": "Best Practices",
+    "practice1": "Use pagination for large datasets",
+    "practice2": "Implement exponential backoff",
+    "practice3": "Handle rate limit headers",
+    "practice4": "Validate responses",
+    "codeExamplesTitle": "Code Examples",
+    "codeExamplesDesc": "Ready-to-use code snippets in multiple programming languages",
+    "authentication": "Authentication",
+    "authDesc": "All API requests require authentication using an API key in the Authorization header:",
+    "headerFormat": "Header Format",
+    "rateLimiting": "Rate Limiting",
+    "rateLimitingDesc": "API requests are rate-limited. Check the X-RateLimit-* headers in responses for current limits and usage.",
+    "interactiveTesting": "Interactive API Testing",
+    "interactiveTestingDesc": "Test API endpoints directly in your browser. No additional tools required!",
+    "howToTest": "How to Test",
+    "howToTestStep1": "Click the \"Authorize\" button below (green lock icon)",
+    "howToTestStep2": "Enter your API key:",
+    "howToTestStep3": "Expand any endpoint and click \"Try it out\"",
+    "howToTestStep4": "Fill in parameters and click \"Execute\"",
+    "quickTestEndpoints": "Quick Test Endpoints",
+    "stagesEndpointDesc": "Best endpoint to test your API key. Returns all production stages.",
+    "jobsGetEndpointDesc": "List all jobs with filtering. Test pagination with limit/offset.",
+    "jobsPostEndpointDesc": "Create a new job. Includes example request body.",
+    "jobsSyncEndpointDesc": "ERP sync endpoint. Upsert by external_id.",
+    "completeApiReference": "Complete API Reference",
+    "completeApiReferenceDesc": "Full OpenAPI specification with all endpoints, schemas, and examples.",
+    "openInSwaggerEditor": "Open in Swagger Editor",
+    "downloaded": "Downloaded!",
+    "downloadedDesc": "OpenAPI spec downloaded as {{filename}}",
+    "downloadError": "Failed to download spec",
+    "copied": "Copied!",
+    "copiedDesc": "{{label}} copied to clipboard",
+    "specUrl": "Spec URL",
+    "postmanImportUrl": "Postman import URL"
+  },
   "dataImport": {
     "title": "Data Import",
     "description": "Import data from CSV files or external systems",
+    "needHelp": "Need Help?",
+    "learnMoreSync": "Learn more about data sync options:",
+    "erpIntegrationGuide": "ERP Integration Guide",
+    "apiDocumentation": "API Documentation",
     "steps": {
       "select": "Select Entity",
       "upload": "Upload File",

src/i18n/locales/nl/translation.json

@@ -1278,6 +1278,92 @@
       "issueResolved": "Probleem opgelost"
     }
   },
+  "apiDocsPage": {
+    "title": "Eryxon Flow API",
+    "description": "Productie workflow management API voor plaatwerk fabricage. Bouw integraties, automatiseer workflows en beheer uw productiegegevens programmatisch.",
+    "version": "v1.0.0",
+    "restApi": "REST API",
+    "restApiDesc": "JSON-gebaseerde RESTful API",
+    "apiKeyAuth": "API-sleutel authenticatie",
+    "apiKeyAuthDesc": "Veilige bearer token authenticatie",
+    "interactiveDocs": "Interactieve documentatie",
+    "interactiveDocsDesc": "Test endpoints direct in de browser",
+    "openApiSpec": "OpenAPI-specificatie",
+    "openApiSpecDesc": "Download de specificatie voor Swagger, Postman of SDK-generatie",
+    "downloadJson": "JSON downloaden",
+    "downloadJsonDesc": "OpenAPI 3.0 specificatie",
+    "downloadYaml": "YAML downloaden",
+    "downloadYamlDesc": "Menselijk leesbaar formaat",
+    "swaggerEditor": "Swagger Editor",
+    "swaggerEditorDesc": "Online bewerken & valideren",
+    "copySpecUrl": "Spec-URL kopiëren",
+    "copySpecUrlDesc": "Directe link naar JSON",
+    "importToPostman": "Importeren in Postman",
+    "importToPostmanDesc": "Postman openen → Import → Link → Plakken:",
+    "copyUrl": "URL kopiëren",
+    "csvImportWizard": "CSV Import Wizard",
+    "helpAndGuides": "Help & handleidingen",
+    "quickStart": "Snelstart",
+    "codeExamples": "Codevoorbeelden",
+    "tryItOut": "Uitproberen",
+    "fullReference": "Volledige referentie",
+    "gettingStarted": "In 3 stappen aan de slag",
+    "gettingStartedDesc": "Begin binnen enkele minuten met API-aanroepen",
+    "step1Title": "API-sleutel genereren",
+    "step1Desc": "Navigeer naar <strong>Admin > API-sleutels</strong> in de webinterface en genereer een nieuwe API-sleutel.",
+    "step1KeyPrefix": "Uw sleutel begint met",
+    "keepApiKeySecure": "Houd uw API-sleutel veilig!",
+    "keepApiKeySecureDesc": "Uw API-sleutel wordt slechts één keer getoond. Bewaar deze veilig en commit deze nooit naar versiebeheer.",
+    "goToApiKeys": "Naar API-sleutels",
+    "step2Title": "Verbinding testen",
+    "step2Desc": "Maak uw eerste API-aanroep om te verifiëren dat uw sleutel werkt. We raden aan te beginnen met het alleen-lezen endpoint",
+    "step2Endpoint": "/api-stages",
+    "step2EndpointDesc": "",
+    "baseUrl": "Basis-URL",
+    "curlExample": "cURL-voorbeeld",
+    "expectedResponse": "Verwachte respons",
+    "step3Title": "Begin met bouwen",
+    "step3Desc": "Verken de API-referentie hieronder om alle beschikbare endpoints te zien en ze interactief te testen.",
+    "commonUseCases": "Veelvoorkomende use cases",
+    "useCase1": "Opdrachten maken vanuit ERP-systemen",
+    "useCase2": "Productievoortgang volgen",
+    "useCase3": "Taakafronding bijwerken",
+    "useCase4": "Opdrachtstatus en metrics opvragen",
+    "bestPractices": "Best practices",
+    "practice1": "Paginering gebruiken voor grote datasets",
+    "practice2": "Exponentiële backoff implementeren",
+    "practice3": "Rate limit headers afhandelen",
+    "practice4": "Responses valideren",
+    "codeExamplesTitle": "Codevoorbeelden",
+    "codeExamplesDesc": "Kant-en-klare code snippets in meerdere programmeertalen",
+    "authentication": "Authenticatie",
+    "authDesc": "Alle API-verzoeken vereisen authenticatie met een API-sleutel in de Authorization header:",
+    "headerFormat": "Header-formaat",
+    "rateLimiting": "Rate limiting",
+    "rateLimitingDesc": "API-verzoeken zijn gelimiteerd. Controleer de X-RateLimit-* headers in responses voor huidige limieten en gebruik.",
+    "interactiveTesting": "Interactief API testen",
+    "interactiveTestingDesc": "Test API-endpoints direct in uw browser. Geen extra tools nodig!",
+    "howToTest": "Hoe te testen",
+    "howToTestStep1": "Klik op de \"Autoriseren\" knop hieronder (groen slot-icoon)",
+    "howToTestStep2": "Voer uw API-sleutel in:",
+    "howToTestStep3": "Vouw een endpoint uit en klik op \"Probeer het uit\"",
+    "howToTestStep4": "Vul de parameters in en klik op \"Uitvoeren\"",
+    "quickTestEndpoints": "Sneltest-endpoints",
+    "stagesEndpointDesc": "Beste endpoint om uw API-sleutel te testen. Retourneert alle productiefasen.",
+    "jobsGetEndpointDesc": "Lijst alle opdrachten met filtering. Test paginering met limit/offset.",
+    "jobsPostEndpointDesc": "Maak een nieuwe opdracht. Bevat voorbeeld request body.",
+    "jobsSyncEndpointDesc": "ERP sync endpoint. Upsert op external_id.",
+    "completeApiReference": "Volledige API-referentie",
+    "completeApiReferenceDesc": "Volledige OpenAPI-specificatie met alle endpoints, schema's en voorbeelden.",
+    "openInSwaggerEditor": "Openen in Swagger Editor",
+    "downloaded": "Gedownload!",
+    "downloadedDesc": "OpenAPI-specificatie gedownload als {{filename}}",
+    "downloadError": "Specificatie kon niet worden gedownload",
+    "copied": "Gekopieerd!",
+    "copiedDesc": "{{label}} naar klembord gekopieerd",
+    "specUrl": "Spec-URL",
+    "postmanImportUrl": "Postman import URL"
+  },
   "dataExport": {
     "title": "Gegevensexport",
     "chooseEntities": "Kies entiteiten",