swagger-api/swagger-editor
Swagger Editor
Swagger Editor هو أداة تأليف قائمة على الويب وبيئة تطوير تستخدم لتصميم وتوثيق والتحقق من مواصفات API. يدعم بشكل خاص مواصفات OpenAPI، ويوفر واجهة متصفح لكتابة مخططات API والتحقق من هيكلها.
تتميز الأداة بالعرض في الوقت الفعلي الذي ينتج معاينة مرئية لوثائق API أثناء تحرير المواصفات. تتضمن تمييز بناء الجملة بناءً على مخططات قياسية لتحسين قابلية قراءة تعريفات API.
يدعم المحرر استيراد المواصفات من ملفات، أو عناوين URL خارجية، أو أمثلة ثابتة، ويحفظ الحالة الحالية في التخزين المحلي لمنع فقدان البيانات. يتم توزيعه كصورة حاوية، بما في ذلك إصدار غير جذري (non-root) لتقليل سطح الهجوم الأمني أثناء النشر.
Features
- API Specification Editors - Provides a web-based environment for designing and documenting API specifications using industry standards.
- OpenAPI Specification Editors - Provides a dedicated environment for authoring and refining API definitions using the OpenAPI Specification.
- Specification Previews - Renders a live visual preview of the API documentation as the specification is edited.
- API Documentation - Facilitates the authoring and visualization of technical API specifications and interface definitions.
- API Specification Definitions - Visualizes API endpoints and data schemas through a live preview during the definition process.
- API Design Tools - Provides a comprehensive environment for drafting and refining API specifications before implementation.
- API Client Preview Editors - Visualizes OpenAPI schemas in real-time using specialized plugins for design systems.
- Visual REST Editors - Offers a live visual preview of API endpoints and schemas that updates in real-time as specifications are edited.
- Technical Specification Interfaces - Implements a browser-based interface for writing and validating API schemas to ensure documentation consistency.
- Containerized Development Tooling - Delivers the editor as a Docker image to eliminate local environment dependencies and ensure consistent setup.
- Editor Behavior Customizations - Allows tailoring the editing experience through plugins and presets for specific behaviors like read-only mode.
- API Specification Importers - Imports API definitions from files, external URLs, or pre-defined example fixtures.
- Container Deployment - Distributes the editor as a container image to ensure consistent environment setup across platforms.
- Unprivileged Container Execution - Packages the application as a non-root container to reduce the security attack surface.
- Containerized Application Deployments - Provides a pre-built Docker image for executing the editor in a containerized environment.
- Non-Root Container Execution Environments - Provides an unprivileged container image to minimize the security attack surface during deployment.
- Plugin-Based Editor Extensibility - Allows injecting custom components and logic into the editor interface via predefined extension points.
- Editor Extensions - Provides extension points to inject custom logic and UI components into the editor interface.
- Syntax Highlighting Editors - Implements a text editor that applies color and style to API specifications for improved readability.
- Syntax Highlighting - Applies color coding to API specification keywords and structures based on standardized schemas.
- API Design Tools - Open-source editor for designing OpenAPI-based APIs.
