Register the URL path and the handler routine with the mcorest core library.
MCO_RET mcorest_api_register_service(mcorest_h rest,
const char *path,
mcorest_api_handler_fn h,
void *ctx,
int allow_partial_match);
| rest | Server instance handle |
| path | Service's URL path |
| h | Request handler routine; see mcorest_api_handler_fn |
| ctx | Context pointer to be passed to the handler |
| allow_partial_match | If not 0, the handler will be passed requests for both path and its children (e.g. handler for "/base" will also receive "/base/child" requests). Otherwise, only exact matches will be accepted * (e.g. "/base", "/base/" or "/base?query"). |
Registers the REST service at the specified path. The registration order matters: the paths should be registered from the most to the least specific. For example: "/base/child" should come before "/base".
| MCO_S_OK = 0 | Success |
| MCO_E_REST_INUSE | A service has already been registered with the path |
| MCO_E_REST_* | Any of the Web Services Error Codes |