Erlaubte Werte bei den Parametern in der API Doc / OpenAPI Spec hinzufügen

[liebsoer]

Moin

mir ist aufgefallen, dass in der REST API Dokumentation die möglichen validen Werte nicht angegeben sind und man diese erst herausfindet, wenn man sie falsch eingibt.

z.B. bei /events würde ich für folgende Parameter einen Hinweis, was ich eingeben darf / welche Werte erlaubt sindhilfreich finden:

• to und from: Y-m-d
• direction: forward, backward
• include: ???

Viele Grüße
Sören