com.wordnik.swagger.annotations

Annotation Type ApiResponse

@Target(value=METHOD)
@Retention(value=RUNTIME)
@Inherited
public @interface ApiResponse

Describes a possible response of an operation.

This can be used to describe possible success and error codes from your REST API call. You may or may not use this to describe the return type of the operation (normally a successful code), but the successful response should be described as well using the ApiOperation.

If your API has uses a different response class for these responses, you can describe them here by associating a response class with a response code. Note, Swagger does not allow multiple response types for a single response code.

This annotation is not used directly and will not be parsed by Swagger. It should be used within the ApiResponses.

See Also:

ApiOperation, ApiResponses

Required Element Summary

Required Elements

Modifier and Type	Required Element and Description
int	code The HTTP status code of the response.
String	message Human-readable message to accompany the response.

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
Class<?>	response Optional response class to describe the payload of the message.

Element Detail

code

public abstract int code

The HTTP status code of the response.

The value should be one of the formal HTTP Status Code Definitions.

message

public abstract String message

Human-readable message to accompany the response.

response

public abstract Class<?> response

Optional response class to describe the payload of the message.

Corresponds to the `responseModel` field of the response message object.

Default:

java.lang.Void.class