heal.abstract |
Κανείς µπορεί να έχει στα χέρια του το καλύτερο REST API, αλλά ϑα είναι αδύνατο να το χρησιµοιήσει σωστά εάν πρώτα δεν το έχει κατανοήσει. Σε αυτό το σηµείο ορίζεται η έννοια του API Documentation, το οποίο αποτελεί ένα έγγραφο που περιγράφει το πως ϑα χρησιµοποιηθεί ένα API. Συχνά το Documentation των REST APIs γίνεται µε το χέρι, κάτι το οποίο είναι χρονοβόρο και µε σηµαντικές πιθανότητες λάθους. Υπάρχουν εργαλεία τα οποία
διευκολύνουν τη δηµιουργία, επεξεργασία και παρουσίαση του API Documentation.
Σε αυτή την εργασία ϑα παρουσιαστεί µία µέθοδος η οποία συνδυάζει τα εργαλεία Postman και Visual Paradigm, µε σκοπό την αυτοµατοποίηση της διαδικασίας παραγωγής και
παρουσίασης του API Documentation. Μέσω του εργαλείου Postman µπορούν να δηµιουργηθούν συλλογές από requests µε όλες τις απαραίτητες πληροφορίες, όπως body, responses,
headers κ.α. Μέσω του εργαλείου Visual Paradigm µπορεί να αναπαρασταθεί ένα OpenAPI Documentation ή να παραχθεί το Documentation του από µία API αναπαράσταση.
Μέσω της εργασίας αυτής δηµιουργήθηκε ένα απλό σύστηµα, το οποίο δέχεται ως είσοδο
την περιγραφή µίας συλλογής από requests του Postman και παράγει το OpenAPI Documentation. Το αρχείο που παράγεται µπορεί να οπτικοποιηθεί µέσω του Visual Paradigm
ως REST API. Επιπλέον το σύστηµά µας, επιτελεί και την αντίστροφη λειτουργία. Μέσω ενός REST API σχεδιασµένο στο Visual Paradigm, παράγει το OpenAPI Documentation του.
Χρησιµοποιώντας το Documentation αυτό στη συνέχεια µπορεί να δηµιουργηθεί ένα REST API στο Postman. |
el |