Module mod_ocs_rest_post
Handle received HTTP POST requests.
Copyright © 2016 - 2026 SigScale Global Inc.
Handle received HTTP POST requests.
This is an httpd callback module handling
HTTP POST operations. The HTTP resources are managed in modules named
ocs_rest_res_*.
The resource handler modules should implement callback functions
in the pattern described in the example below.
post_<Collection>([Id], RequestBody, [...]) -> Result
- Id = string()
- RequestBody = string()
- Result = {ok, Headers, ResponseBody}
| {200, Headers, ResponseBody}
| {error, StatusCode}
| {error, StatusCode, Problem}
- ResponseBody = io_list()
- StatusCode = 200..599
- Problem = #{type := uri(), title := string(),
code := string(), cause => string(), detail => string(),
invalidParams => [#{param := string(), reason => string()}],
status => 400..599}
Resource handlers for HTTP POST operations on REST Collections.
Response Headers must include content_type if ResponseBody is
not en empty list. An optional Problem report may be provided in
error responses which shall be formatted by
format_problem/2 and included
in the response body.
| do/1 | Erlang web server API callback function. |
do(ModData) -> Result
- ModData = #mod{}
- Result = {proceed, OldData} | {proceed, NewData} | {break, NewData} | done
- OldData = list()
- NewData = [{response, {StatusCode, Body}}] | [{response, {response, Head, Body}}] | [{response, {already_sent, StatusCode, Size}}]
- StatusCode = integer()
- Body = iolist() | nobody | {Fun, Arg}
- Head = [HeaderOption]
- HeaderOption = {Option, Value} | {code, StatusCode}
- Option = accept_ranges | allow | cache_control | content_MD5 | content_encoding | content_language | content_length | content_location | content_range | content_type | date | etag | expires | last_modified | location | pragma | retry_after | server | trailer | transfer_encoding
- Value = string()
- Size = term()
- Fun = fun((Arg) -> sent | close | Body)
- Arg = [term()]
Erlang web server API callback function.
Generated by EDoc
