Verschachtelte Kategorien werden nicht korrekt angezeigt
Wenn es eintritt: Endpunkte, die in verschachtelten Unterkategorien erscheinen sollten, sind nach dem Import nicht hierarchisch organisiert.
So funktioniert es: Document360 unterstützt Unterkategorien der zweiten Ebene mit dem > Symbol in OpenAPI-Tags. Zum Beispiel erzeugt ein Tag von Pets > Details eine Pets Kategorie mit einer Details Unterkategorie darin. Diese Struktur bleibt während der Resynchronisation erhalten.
tags:
- name: "Pets > Details"
i️ HINWEIS
Der API-Dokumentationsbereich unterstützt maximal drei Ebenen von Unterkategorien. Wenn deine Spezialisierung mehr als drei Level umfasst, werden alle zusätzlichen Level auf der dritten Stufe platziert.
Die Kategorienreihenfolge ist nicht das, was ich erwartet hatte
Wenn es eintritt: Nach dem Hochladen einer Spezifikation erscheinen die Kategorien in einer anderen Reihenfolge als erwartet.
Warum es passiert: Kategorien in Document360 werden basierend auf der in der Spezifikationsdatei definierten Tag-Reihenfolge erstellt. Die Reihenfolge der Tags in deiner Spezifikation bestimmt, welche Reihenfolgekategorien in der Dokumentation erscheinen.
Wie man es behebt: Ordne das tags Array in deiner OpenAPI-Spezifikation so um, dass es mit der gewünschten Kategorienreihenfolge übereinstimmt, und synchronisiere dann neu.