Εάν εξακολουθείτε να μην χρησιμοποιείτε γλώσσα ορισμού για προδιαγραφές API αναγνώσιμες από μηχανή, όπως το OpenAPI (παλαιότερα γνωστό ως Swagger), θα πρέπει οπωσδήποτε να σκεφτείτε να το κάνετε. Σε τελική ανάλυση, τα API είναι γλώσσες όπου οι μηχανές μπορούν να μιλούν μεταξύ τους.
Είναι καλή ιδέα το Swagger;
Ο Swagger κάνει μια πολύ καλή πρώτη εντύπωση Εξάλλου, πολλοί άνθρωποι πιστεύουν ότι η δυνατότητα δημιουργίας κώδικα από την τεκμηρίωση είναι καλή ιδέα και ο Swagger παρέχει ότι επισης. Έτσι, το γεγονός ότι το swagger κάνει μια εξαιρετική πρώτη εντύπωση, κάνει τους περιορισμούς και τους περιορισμούς του λιγότερο εμφανείς.
Ποιος είναι ο σκοπός της χρήσης του Swagger;
Το
Swagger σας επιτρέπει να περιγράψετε τη δομή των API σας, ώστε τα μηχανήματα να μπορούν να τα διαβάσουν. Η ικανότητα των API να περιγράφουν τη δική τους δομή είναι η ρίζα κάθε φοβερότητας στο Swagger.
Χρησιμοποιείται ακόμα το Swagger;
Σήμερα, πολλοί χρήστες εξακολουθούν να χρησιμοποιούν τους όρους " Swagger" για να αναφέρονται στη μορφή προδιαγραφών OpenAPI 2.0 και "Προδιαγραφές Swagger" για να αναφέρονται σε ένα έγγραφο περιγραφής API σε αυτήν τη μορφή. Το RepreZen API Studio χρησιμοποιεί αυτούς τους όρους σε ορισμένα τμήματα της διεπαφής χρήστη, αλλά αναφέρεται στο OpenAPI 3.0 και σε νεότερες εκδόσεις ως "OpenAPI. "
Είναι το swagger μόνο για REST API;
Η
Προδιαγραφές OpenAPI (πρώην Προδιαγραφή Swagger) είναι μια μορφή περιγραφής API για REST API. Ένα αρχείο OpenAPI σάς επιτρέπει να περιγράψετε ολόκληρο το API σας, συμπεριλαμβανομένων των εξής: Διαθέσιμα τελικά σημεία (/users) και λειτουργίες σε κάθε τελικό σημείο (GET /users, POST /users)
