How to generate documentation and attribution to error codes

[JASKevinWhite]

I'm working on an API. Certain calls to the API can result in HTTP errors being returned. My problem is that the docs pages and the YAML don't refer to the error. For example:

type LoginResponse struct {
	Body LoginResponseBody
}

// LoginResponseBody represents the JSON response for a login request.
type LoginResponseBody struct {
	Message   string `json:"message"`              // A human-readable message (e.g., "Login successful" or "Invalid credentials").
	Token     string `json:"token,omitempty"`      // A JWT or session token (only included on successful login).
	ExpiresIn int    `json:"expires_in,omitempty"` // Token expiration time in seconds (only included on successful login).
	Error     string `json:"error,omitempty"`      // Error message (only included on failed login).
}


	huma.Register(grp, huma.Operation{
		OperationID:   "login",
		Method:        http.MethodGet,
		Path:          "/login/{username}/{password}",
		Summary:       "Request a token",
		Description:   "Request a token for a given username and password",
		Tags:          []string{"DPDB"},
		DefaultStatus: 200,
	},
		func(ctx context.Context, input *struct {
			Username string `path:"username" maxLength:"255" example:"myusername" doc:"Username for login"`
			Password string `path:"password" maxLength:"255" example:"mypassword" doc:"Password for login"`
		}) (*LoginResponse, error) {
			_, err := dbNameLookup(input.Username, int(1))
			if err != nil {
				return &LoginResponse{
					Body: LoginResponseBody{
						Message: "Login failed",
						Error:   "Invalid username or password",
					},
				}, huma.Error401Unauthorized("Invalid credentials")
			}
			return &LoginResponse{
				Body: LoginResponseBody{
					Message:   "Login successful",
					Token:     "blahblahblah",
					ExpiresIn: 60 * 60, // 1 hour in seconds
				},
			}, nil
		})

Note, the code obviously isn't complete and I know that passing username/password as GET path parameters isn't likely what I want.

The documentation page only shows the 200 response. It doesn't show the 401.

I know I can add this to the Operation:

		Responses: map[string]*huma.Response{
			"200": {Description: "Login successful"},
			"401": {Description: "Invalid credentials"},
		},

Is that what I'm supposed to do? If I have different HTTP responses for a given operation, am I to maintain that map manually?

Thanks...

[wolveix]

Duplicate of #451, continuing the discussion there :)