# README
go-katapult
Go client library for Katapult.
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