Swagger - not in sync with output

Hi Guys,

small technical issue/challange/request. We love the way Xano generates Swagger documentation. Our frontend team even wrote a tool that imports the swagger and transforms it to typscript so they have the correct typing in their development tools.

Small issue we run into is that the response example/schema doesn't always match the actual response. The reason is that the Swagger docs only include the database structure as example and not manualy added variables.

Example:

https://xano.esperantoxl.nl/api:SJYkNh_R

The /person endpoints provides records directly from the database.

The /person/{person_id} endpoint provides a record and adds a concat for the entire name.

One way to get the model.name variable in the swagger documentation is to add a placeholder field to the database but this seems iffy.

Could we add something to be able to add fields like this to the swagger examples values/schema? This would make type matching so much easier for frontend developers.

6
6 replies