Μπορεί Swagger περιγράφουν μια σειρά από σύνθετους τύπους σε QueryString για το Microsoft Web API

ψήφοι
0

Προσπαθώ να προσθέσετε Swagger doc για API μου, η οποία χρησιμοποιεί το Microsoft πλαισίου Web API.

Για παράδειγμα περνώντας ένα συστοιχία GeoPoint (Lat / Lon) αντικείμενα, Web API αναμένει συστοιχίες των σύνθετους τύπους που δεσμεύονται από το QueryString να έχει την ακόλουθη μορφή.

/api/Location?points[0][Lat]=1.2&points[0][Lon]=3.4

Αυτό λειτουργεί.

Η ερώτησή μου: είναι δυνατόν να τεκμηριωθεί αυτό το μορφότυπο συλλογής και τον τύπο πίνακα σε ένα έγγραφο Swagger JSON;

Νομίζω ότι το σχετικό spec είναι εδώ http://swagger.io/specification/#parameterObject

Με τον τύπο = array και collectionFormat = multi φαίνεται να θέλει να επαναλάβει την παράμετρο «σημεία», αλλά δεν ξέρετε για το ευρετήριο πίνακα [0] μέρος.

Δημοσιεύθηκε 09/06/2016 στις 10:42
πηγή χρήστη
Σε άλλες γλώσσες...                            


1 απαντήσεις

ψήφοι
1

δεν είναι πραγματικά. Κατ 'αρχάς, παραμέτρους ερωτήματος στον ορισμό έπαρση είναι πρωτόγονη αξίες, ή συστοιχίες των πρωτόγονων τιμών. Στη συνέχεια, η ανάθεση των θέσεων συστοιχίας σε μια συμβολοσειρά ερωτήματος μέσω υποκατάσταση δεν είναι μέρος του προτύπου κορδόνομαι-ui. Μπορείτε πιθανώς να το κάνουν να λειτουργήσει, αλλά υποψιάζομαι ότι κανένα από τα άλλα φανταχτερά ρούχα εργαλεία θα ξέρουν τι να κάνουν με αυτό.

Απαντήθηκε 14/06/2016 στις 13:53
πηγή χρήστη

Cookies help us deliver our services. By using our services, you agree to our use of cookies. Learn more