fi.metatavu.edelphi.rest.api.UsersApi Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of edelphi-api-spec Show documentation

Specifications for eDelphi API

There is a newer version: 1.0.47

package fi.metatavu.edelphi.rest.api;

import fi.metatavu.edelphi.rest.model.*;
import java.util.UUID;

import javax.ws.rs.*;
import javax.ws.rs.core.Response;

import io.swagger.annotations.*;

import java.util.Map;
import java.util.List;
import javax.validation.constraints.*;
import javax.validation.Valid;

@Path("/users")
@Api(description = "the users API")
@javax.annotation.Generated(value = "io.swagger.codegen.v3.generators.java.JavaJAXRSSpecServerCodegen", date = "2019-08-06T10:40:24.181+03:00[Europe/Helsinki]")
public interface UsersApi {

    @GET
    @Path("/{userId}")
    @Produces({ "application/json" })
    @ApiOperation(value = "Find user", notes = "Finds an user by id", authorizations = {
        @Authorization(value = "bearer")    }, tags={ "Users" })
    @ApiResponses(value = { 
        @ApiResponse(code = 200, message = "Found user", response = User.class),
        @ApiResponse(code = 400, message = "Invalid request was sent to the server", response = ErrorResponse.class),
        @ApiResponse(code = 403, message = "Attempted to make a call with unauthorized client", response = ErrorResponse.class),
        @ApiResponse(code = 500, message = "Internal server error", response = ErrorResponse.class) })
    Response findUser(@PathParam("userId")  UUID userId);}