Function headerParam
Declare that a parameter will be transmitted to the API through the headers.
If the parameter is a string, or any scalar type (float, int, char[], ...), it will be send as a string. If it's an aggregate, it will be serialized as JSON. However, passing aggregate via header isn't a good practice and should be avoided for new production code.
There are currently two kinds of symbol to do this: viaHeader
and headerParam
.
viaHeader
should be applied to the parameter itself, while headerParam
is applied to the function.
headerParam
was introduced long before the D language for UDAs on parameters
(introduced in DMD v2.082.0), and will be deprecated in a future release.
Parameters
Name | Description |
---|---|
identifier | The name of the parameter to customize. A compiler error will be issued on mismatch. |
field | The name of the header field to use (e.g: 'Accept', 'Content-Type'...). ---- // The server will receive the content of the "Authorization" header. void login(@viaHeader("Authorization") string auth); ---- |