serviceapi

package

v0.1.0-rc.35 Latest Latest Go to latest Published: Sep 29, 2026 License: MIT Imports: 11 Imported by: 0

Details

Package serviceapi provides HTTP helpers for the private service APIs.

View Source

const MaximumRequestBytes = 64 << 10

This section is empty.

func DecodeJSON(response http.ResponseWriter, request *http.Request, destination any) bool

func Nonnegative(value int64) (uint64, bool)

func Positive(value int64) (uint64, bool)

func ValidIdentifiers(values ...string) bool

func WriteJSON(response http.ResponseWriter, status int, value any)

func WriteProblem(response http.ResponseWriter, status int, problemType, detail string)

func WriteProblemError(response http.ResponseWriter, problem *ProblemError)

type BearerSecrets struct {
	// contains filtered or unexported fields
}

BearerSecrets authenticates a current service secret and an optional previous secret retained only for a rolling rotation.

func NewBearerSecrets(current, previous string) (BearerSecrets, error)

func (s BearerSecrets) Authenticate(header http.Header) bool

func (s BearerSecrets) Matches(candidate string) bool

func (s BearerSecrets) Valid() bool

type ProblemError struct {
	Status int
	Type   string
	Title  string
	Detail string
}

ProblemError describes a private service API failure without HTTP client or server details.

func NewProblemError(status int, problemType, detail string) *ProblemError

func (e *ProblemError) Error() string