drone/internal/api/openapi/principals.go

36 lines
1.3 KiB
Go

// Copyright 2022 Harness Inc. All rights reserved.
// Use of this source code is governed by the Polyform Free Trial License
// that can be found in the LICENSE.md file for this repository.
package openapi
import (
"net/http"
"github.com/harness/gitness/internal/api/usererror"
"github.com/harness/gitness/types"
"github.com/swaggest/openapi-go/openapi3"
)
type (
// principalRequest is the request for finding a principal.
principalRequest struct {
PrincipalUID string `path:"principal_uid"`
}
)
// buildPrincipals function that constructs the openapi specification
// for principal resources.
func buildPrincipals(reflector *openapi3.Reflector) {
opFind := openapi3.Operation{}
opFind.WithTags("principals")
opFind.WithMapOfAnything(map[string]interface{}{"operationId": "getPrincipal"})
_ = reflector.SetRequest(&opFind, new(principalRequest), http.MethodGet)
_ = reflector.SetJSONResponse(&opFind, new(types.PrincipalInfo), http.StatusOK)
_ = reflector.SetJSONResponse(&opFind, new(usererror.Error), http.StatusBadRequest)
_ = reflector.SetJSONResponse(&opFind, new(usererror.Error), http.StatusInternalServerError)
_ = reflector.SetJSONResponse(&opFind, new(usererror.Error), http.StatusNotFound)
_ = reflector.Spec.AddOperation(http.MethodGet, "/principals/{principal_uid}", opFind)
}