# Επικυρωτής OpenAPI

Ελέγξτε ένα έγγραφο OpenAPI 3.0, 3.1 ή 3.2 ή Swagger 2.0 σε YAML ή JSON και λάβετε μια σύνοψη των endpoint και των σχημάτων του. Ο επικυρωτής ελέγχει τα απαιτούμενα πεδία, τα πρότυπα διαδρομών σε σχέση με τις παραμέτρους διαδρομής, τις θέσεις παραμέτρων, τους κωδικούς απόκρισης, τα διπλότυπα operation ID και κάθε τοπικό $ref, και παραθέτει κάθε πρόβλημα μαζί με τη θέση του.

## Συχνές ερωτήσεις

### Τι ελέγχει ο επικυρωτής;

Ελέγχει την έκδοση openapi ή swagger, τα info.title και info.version, ότι οι διαδρομές αρχίζουν με κάθετο, ότι κάθε {parameter} σε μια διαδρομή έχει αντίστοιχη υποχρεωτική παράμετρο διαδρομής και το αντίστροφο, τα ονόματα και τις θέσεις παραμέτρων, τους κωδικούς κατάστασης και τις περιγραφές αποκρίσεων, τις διπλότυπες παραμέτρους, τις διπλότυπες τιμές operationId, καθώς και ότι κάθε τοπικό $ref παραπέμπει σε κάτι μέσα στο έγγραφο.

### Πρόκειται για πλήρη επικύρωση του σχήματος JSON της προδιαγραφής;

Όχι. Ελέγχει τους παραπάνω δομικούς κανόνες, οι οποίοι εντοπίζουν τα περισσότερα λάθη σε έγγραφα που έχουν γραφτεί με το χέρι, αλλά δεν επικυρώνει κάθε πεδίο βάσει του επίσημου μετασχήματος ούτε ελέγχει το περιεχόμενο των σχημάτων σας.

### Τι εμφανίζει η σύνοψη;

Την προδιαγραφή και την έκδοση API, τον τίτλο, έναν πίνακα με κάθε endpoint, τη μέθοδο, τη διαδρομή, το operationId, τη σύνοψη και τους κωδικούς απόκρισης, καθώς και τα ονόματα των σχημάτων στο components.schemas ή, στο Swagger 2.0, στα definitions.

### Ακολουθούνται οι εξωτερικές αναφορές;

Όχι. Οι αναφορές σε άλλα αρχεία ή URL δεν ανακτώνται ούτε αναφέρονται. Επιλύονται μόνο αναφορές που αρχίζουν με # μέσα στο επικολλημένο έγγραφο.

### Ποια είναι η διαφορά μεταξύ σφαλμάτων και προειδοποιήσεων;

Τα σφάλματα παραβιάζουν έναν κανόνα της προδιαγραφής, για παράδειγμα μια περιγραφή απόκρισης που λείπει ή μια παράμετρος διαδρομής που δεν έχει δηλωθεί. Οι προειδοποιήσεις επισημαίνουν πράγματα που επιτρέπονται αλλά συνήθως δεν είναι σκόπιμα, όπως μια λειτουργία GET με σώμα αιτήματος ή ένα έγγραφο χωρίς operationId.

### Αλλάζει το OpenAPI 3.1 τα απαιτούμενα στοιχεία;

Ναι. Στα OpenAPI 3.1 και 3.2 μια λειτουργία δεν χρειάζεται πλέον αντικείμενο responses, ενώ ένα έγγραφο μπορεί να έχει webhooks ή components αντί για paths. Ο επικυρωτής εφαρμόζει αυτούς τους κανόνες όταν το πεδίο openapi αρχίζει με 3.1 ή 3.2.

Η διαφήμισή σας εδώ;

[Στείλτε μας email](mailto:hi@dennn.is?subject=%CE%94%CE%B9%CE%B1%CF%86%CE%AE%CE%BC%CE%B9%CF%83%CE%B7%20%CF%83%CF%84%CE%BF%20OneClick%20Pro)

[Διαφήμιση 433 εργαλεία για τους AI agents σας μέσω ενός διακομιστή MCP.](https://multitaskai.com/el/?ref=oneclickpro)
