Categorygithub.com/krystal/go-katapult
modulepackage
0.2.11
Repository: https://github.com/krystal/go-katapult.git
Documentation: pkg.go.dev

# README

logo

go-katapult

Go client library for Katapult.

Actions Status Coverage GitHub last commit GitHub issues GitHub pull requests License Status


WARNING: Work in progress; features are missing, there will be breaking changes.


Documentation:

Experimental "next" Client

A more feature complete client is being generated in the next package. The aim for this client is to be generated from an openapi spec and should offer access to everything that is documented / exposed in our API documentation.

Usage Guidance

Each endpoint has multiple functions for calling it. Typically FunctionName and FunctionNameWithResponse are provided.

It is recommended to use the FunctionNameWithResponse functions as they return a response object that contains the response data and the HTTP response object.

The FunctionName functions are provided for convenience and return only the response data.

Example

res, err := client.GetDataCenterDefaultNetworkWithResponse(ctx,
	&katapult.GetDataCenterDefaultNetworkParams{
		DataCenterPermalink: "perma-link",
	},
)

# Packages

No description provided by the author
Package buildspec implements the Katapult Virtual Machine build spec XML document format.
Package katapult is a client for katapult.io's API.
Package namegenerator provides various helper methods to generate randomized names for use on the Katapult platform.
No description provided by the author
No description provided by the author
No description provided by the author

# Functions

No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
RequestSetHeader sets a header on the outgoing request.
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author

# Constants

No description provided by the author
No description provided by the author

# Variables

No description provided by the author
Err is the top-most parent of any error returned by katapult.
HTTP status-based errors.
HTTP status-based errors.
ErrConfig is returned when there's a configuration related issue.
HTTP status-based errors.
HTTP status-based errors.
HTTP status-based errors.
HTTP status-based errors.
HTTP status-based errors.
HTTP status-based errors.
ErrRequest is returned when there's an issue with building the request.
ErrResourceNotFound is a parent error of all resource-specific not found errors.
ErrResponse is the parent of all response API related errors.
ErrRouteNotFound indicates the API endpoint called does not exist.
No description provided by the author
HTTP status-based errors.
HTTP status-based errors.
HTTP status-based errors.
ErrUnexpectedResponse is returned if the response body did not contain expected data.
ErrUnknown is returned if the response error could not be understood.
HTTP status-based errors.

# Structs

No description provided by the author
CommonError handles common logic shared between all API-based error types.
No description provided by the author
Request represents a HTTP request to the Katapult API, it is essentially similar to http.Request, but stripped down to the bare essentials, with some Katapult-specific attributes added.
No description provided by the author
No description provided by the author
ScopeNotGrantedError: The scope required for this endpoint has not been granted to the authenticating identity.
No description provided by the author

# Interfaces

No description provided by the author

# Type aliases

No description provided by the author
No description provided by the author