openapi.h

Go to the documentation of this file.

 
#ifndef CWIST_OPENAPI_H
#define CWIST_OPENAPI_H
 
#include <cwist/sys/app/app.h>
 
/* Source-level route macros: preserve normal runtime routing while leaving an
 * unambiguous, parseable declaration for documentation tooling. */
#define CWIST_OPENAPI_GET(app, path, handler) cwist_app_get((app), (path), (handler))
#define CWIST_OPENAPI_POST(app, path, handler) cwist_app_post((app), (path), (handler))
#define CWIST_OPENAPI_PUT(app, path, handler) cwist_app_put((app), (path), (handler))
#define CWIST_OPENAPI_DELETE(app, path, handler) cwist_app_delete((app), (path), (handler))
#define CWIST_OPENAPI_PATCH(app, path, handler) cwist_app_patch((app), (path), (handler))
 
typedef struct {
    const char *title;       
    const char *version;     
    const char *description; 
    const char *server_url;  
} cwist_openapi_meta_t;
 
void cwist_app_enable_openapi(cwist_app *app, const char *json_path,
                              const cwist_openapi_meta_t *meta);
 
void cwist_openapi_annotate(cwist_app *app, const char *method, const char *path,
                            const char *summary, const char *tags);
 
#endif