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.