OhAPI
Une application macOS native pour les développeurs et architectes API. Visualisez, naviguez et comprenez les spécifications OpenAPI complexes grâce à des diagrammes en arbre interactifs, du code coloré syntaxiquement et un navigateur d'opérations structuré.
Fonctionnalités
Rapide & Natif
Application macOS native, rapide et légère.
Collections
Organisez vos requêtes en collections réutilisables.
Authentification
Support OAuth, Bearer, Basic et plus.
Visualisation interactive en arbre
Transformez votre spécification API en un diagramme en arbre interactif et navigable. Chaque type d'élément est rendu sous forme de nœud distinct et coloré pour une reconnaissance instantanée.
- Nœuds dépliables/repliables — Concentrez-vous sur l'essentiel
- Clic pour sélectionner — Met en surbrillance le code source correspondant
- Animations fluides — Transitions d'arbre soignées
- Navigation par référence — Cliquez sur les nœuds $ref pour accéder aux définitions
Visionneuse de code avec coloration syntaxique
Consultez votre spécification brute avec une coloration syntaxique complète. Sélectionner un nœud de l'arbre fait défiler automatiquement la visionneuse de code jusqu'à l'emplacement source correspondant.
- Coloration JSON et YAML — Clés, valeurs et délimiteurs chacun dans des couleurs distinctes
- Numéros de ligne — Référencez facilement des lignes spécifiques
- Synchronisation avec le code source — Sélectionnez un nœud, la visionneuse défile jusqu'à la ligne correspondante
- Police SF Mono — Rendu monospace net et précis
Navigateur d'opérations
Naviguez dans votre API par opération grâce à un navigateur visuel et structuré.
- Liste des opérations — Toutes les opérations listées avec méthode HTTP et chemin
- Icônes de méthode — GET, POST, PUT, DELETE, PATCH, OPTIONS, HEAD, TRACE ont chacune leur propre icône visuelle
- Détails de l'opération — Consultez le résumé, l'identifiant et la description
- Explorateur de réponses — Parcourez les définitions de requêtes et réponses avec regroupement par code de statut HTTP
1. Ouvrez votre spécification OpenAPI
Ouvrez des fichiers via Fichier > Ouvrir, glisser-déposer, ou double-clic depuis le Finder. OhAPI prend en charge les formats JSON et YAML. Deux spécifications d'exemple sont incluses pour démarrer immédiatement.
2. Sélectionnez une opération
Parcourez et sélectionnez l'opération API que vous souhaitez explorer. Consultez son résumé, son identifiant et sa description. Puis choisissez un message de requête ou de réponse à inspecter.
3. Explorez l'arbre et le code source
L'arbre interactif se met à jour pour afficher la structure de données du message. Survolez un élément pour voir sa description. Sélectionnez un nœud pour mettre en surbrillance sa définition dans la visionneuse de code.
Types de nœuds de l'arbre
OhAPI représente chaque élément OpenAPI sous forme de nœud visuel distinct et coloré.
Schéma
Définitions de types de données avec type, format et contraintes.
Propriété
Propriétés d'objet avec nom, type, indicateur obligatoire et format.
Paramètre
Paramètres de requête, chemin, en-tête et cookie.
Référence
Pointeurs $ref avec navigation en un clic vers la définition cible.
Composition
Composition de schémas via allOf (intersection), anyOf (union) ou oneOf (alternatives exclusives).
Requête et réponse
Corps d'opération avec regroupement par code de statut HTTP et nœuds de type de contenu.
Aperçu de l'interface
Interface principale d'OhAPI avec visualisation en arbre, visionneuse de code et navigateur d'opérations
Thèmes et apparence
OhAPI inclut un système de thèmes avec des couleurs personnalisables pour chaque type de nœud. Les nœuds de propriété, paramètre, référence, type de contenu et erreur ont chacun des couleurs de premier plan, de remplissage et de bordure configurables.
- Prend en charge les modes d'apparence clair et sombre de macOS
- Les paramètres sont conservés d'une session à l'autre
Compatibilité
Versions OpenAPI prises en charge
| Version | Statut |
|---|---|
| Swagger 2.0 | Supporté |
| OpenAPI 3.0.0 | Supporté |
| OpenAPI 3.0.1 | Supporté |
| OpenAPI 3.0.2 | Supporté |
| OpenAPI 3.0.3 | Supporté |
| OpenAPI 3.1.x | Supporté |
Formats pris en charge
| Format | Extensions |
|---|---|
| JSON | .json |
| YAML | .yaml, .yml |
Configuration requise
| Prérequis | Minimum |
|---|---|
| Système d'exploitation | macOS 12.0 (Monterey) |
| Architecture | Intel et Apple Silicon (Universel) |
Questions fréquentes
Puis-je modifier des spécifications avec OhAPI ?
Non, OhAPI est une visionneuse de spécifications. Pour l'édition, consultez OhAPI Designer.
OhAPI prend-il en charge la composition de schémas (allOf, oneOf, anyOf) ?
Oui, OhAPI prend pleinement en charge les mots-clés de composition allOf (intersection), anyOf (union) et oneOf (alternatives exclusives).
Quels formats de documents sont pris en charge ?
OhAPI prend en charge les formats JSON (.json) et YAML (.yaml, .yml).
Quelle est la politique de confidentialité d'OhAPI ?
Nous ne collectons aucune donnée personnelle.
Quelles versions d'OpenAPI sont prises en charge ?
Swagger 2.0 et OpenAPI 3.0.0 à 3.1.x sont pleinement pris en charge. La version est automatiquement détectée à partir de la spécification.
OhAPI gère-t-il les références circulaires ?
Oui, OhAPI inclut une détection de cycles qui gère élégamment les références $ref circulaires, empêchant la récursion infinie.
Puis-je ouvrir plusieurs documents à la fois ?
Oui, OhAPI est une application macOS standard basée sur les documents. Plusieurs documents peuvent être ouverts simultanément dans des fenêtres séparées.
OhAPI prend-il en charge le mode sombre ?
Oui, OhAPI prend en charge les modes d'apparence clair et sombre de macOS avec des couleurs de nœuds personnalisables.
Vous cherchez un éditeur ?
OhAPI Designer est un éditeur macOS natif avec des complétions contextuelles, une validation en ligne et des modèles de snippets pour les spécifications OpenAPI.