requests

Documentation

Index

• func IsAPIKeyExpiredError(err error) bool
• func SignRequest(req *http.Request, privKey string) error
• func WebhookEndpointCreate(ctx context.Context, baseURL, apiVersion, apiKey, url, description string, ...) error
• type Base
  • func (rb *Base) BuildDataForRequest(params *RequestParameters) (string, error)
  • func (rb *Base) Confirm() (bool, error)
  • func (rb *Base) InitFlags()
  • func (rb *Base) MakeMultiPartRequest(ctx context.Context, apiKey, path string, params *RequestParameters, ...) ([]byte, error)
  • func (rb *Base) MakeRequest(ctx context.Context, apiKey, path string, params *RequestParameters, ...) ([]byte, error)
  • func (rb *Base) MakeRequestWithClient(ctx context.Context, client stripe.RequestPerformer, path string, ...) ([]byte, error)
  • func (rb *Base) MakeV2Request(ctx context.Context, apiKey, path string, params *RequestParameters, ...) ([]byte, error)
  • func (rb *Base) RunRequestsCmd(cmd *cobra.Command, args []string) error
• type PluginData
  • func GetPluginData(ctx context.Context, baseURL, apiVersion, apiKey string, ...) (PluginData, error)
• type RequestError
  • func (e RequestError) Error() string
• type RequestParameters
  • func (r *RequestParameters) AppendData(data []string)
  • func (r *RequestParameters) AppendExpand(fields []string)
  • func (r *RequestParameters) SetIdempotency(value string)
  • func (r *RequestParameters) SetStripeAccount(value string)
  • func (r *RequestParameters) SetVersion(value string)
• type TracedTransport
  • func (t *TracedTransport) DNSDone(dnsInfo httptrace.DNSDoneInfo)
  • func (t *TracedTransport) GotConn(connInfo httptrace.GotConnInfo)
  • func (t *TracedTransport) RoundTrip(req *http.Request) (*http.Response, error)
• type WebhookEndpoint
• type WebhookEndpointList
  • func WebhookEndpointsList(ctx context.Context, baseURL, apiVersion, apiKey string, ...) WebhookEndpointList
  • func WebhookEndpointsListWithClient(ctx context.Context, client stripe.RequestPerformer, apiVersion string, ...) WebhookEndpointList

Functions

func IsAPIKeyExpiredError

func IsAPIKeyExpiredError(err error) bool

IsAPIKeyExpiredError returns true if the provided error was caused by a request returning an `api_key_expired` error code.

See https://stripe.com/docs/error-codes/api-key-expired.

func SignRequest

func SignRequest(req *http.Request, privKey string) error

SignRequest takes the http request and signs the request to send to Stripe. You MUST call this function AFTER all headers on the request have been set.

func WebhookEndpointCreate

func WebhookEndpointCreate(ctx context.Context, baseURL, apiVersion, apiKey, url, description string, connect bool, profile *config.Profile) error

WebhookEndpointCreate creates a new webhook endpoint

Types

type Base

type Base struct {
	Cmd *cobra.Command

	Method  string
	Profile *config.Profile

	Parameters RequestParameters

	// SuppressOutput is used by `trigger` to hide output
	SuppressOutput bool

	DarkStyle bool

	APIBaseURL string

	Livemode bool
	// contains filtered or unexported fields
}

Base encapsulates the required information needed to make requests to the API

func (*Base) BuildDataForRequest

func (rb *Base) BuildDataForRequest(params *RequestParameters) (string, error)

BuildDataForRequest builds request payload Note: We converted to using two arrays to track keys and values, with our own implementation of Go's url.Values Encode function due to our query parameters being order sensitive for API requests involving arrays like `items` for `/v1/orders`. Go's url.Values uses Go's map, which jumbles the key ordering, and their Encode implementation sorts keys by alphabetical order, but this doesn't work for us since some API endpoints have required parameter ordering. Yes, this is hacky, but it works.

func (*Base) Confirm

func (rb *Base) Confirm() (bool, error)

Confirm calls the confirmCommand() function, triggering the confirmation process

func (*Base) InitFlags

func (rb *Base) InitFlags()

InitFlags initialize shared flags for all requests commands

func (*Base) MakeMultiPartRequest

func (rb *Base) MakeMultiPartRequest(ctx context.Context, apiKey, path string, params *RequestParameters, errOnStatus bool) ([]byte, error)

MakeMultiPartRequest will make a multipart/form-data request to the Stripe API with the specific variables given to it. Similar to making a multipart request using curl, add the local filepath to params arg with @ prefix. e.g. params.AppendData([]string{"photo=@/path/to/local/file.png"})

func (*Base) MakeRequest

func (rb *Base) MakeRequest(ctx context.Context, apiKey, path string, params *RequestParameters, errOnStatus bool, additionalConfigure func(req *http.Request) error) ([]byte, error)

MakeRequest will make a request to the Stripe API with the specific variables given to it

func (*Base) MakeRequestWithClient

func (rb *Base) MakeRequestWithClient(ctx context.Context, client stripe.RequestPerformer, path string, params *RequestParameters, errOnStatus bool, additionalConfigure func(req *http.Request) error) ([]byte, error)

MakeRequestWithClient will make a request to the Stripe API with the specific variables given to it using the provided client.

func (*Base) MakeV2Request

func (rb *Base) MakeV2Request(ctx context.Context, apiKey, path string, params *RequestParameters, errOnStatus bool, additionalConfigure func(req *http.Request) error, jsonPayload string) ([]byte, error)

MakeV2Request will make a application/json request to the Stripe API with the specific payload given to it.

func (*Base) RunRequestsCmd

func (rb *Base) RunRequestsCmd(cmd *cobra.Command, args []string) error

RunRequestsCmd is the interface exposed for the CLI to run network requests through

type PluginData

type PluginData struct {
	PluginBaseURL       string   `json:"base_url"`
	AdditionalManifests []string `json:"additional_manifests,omitempty"`
}

PluginData contains the plugin download information

func GetPluginData

func GetPluginData(ctx context.Context, baseURL, apiVersion, apiKey string, profile *config.Profile) (PluginData, error)

GetPluginData returns the plugin download information

type RequestError

type RequestError struct {
	StatusCode int
	ErrorType  string
	ErrorCode  string
	Body       interface{} // the raw response body
	// contains filtered or unexported fields
}

RequestError captures the response of the request that resulted in an error

func (RequestError) Error

func (e RequestError) Error() string

type RequestParameters

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

RequestParameters captures the structure of the parameters that can be sent to Stripe

func (*RequestParameters) AppendData

func (r *RequestParameters) AppendData(data []string)

AppendData appends data to the request parameters.

func (*RequestParameters) AppendExpand

func (r *RequestParameters) AppendExpand(fields []string)

AppendExpand appends fields to the expand parameter.

func (*RequestParameters) SetIdempotency

func (r *RequestParameters) SetIdempotency(value string)

SetIdempotency sets the value for the `Idempotency-Key` header.

func (*RequestParameters) SetStripeAccount

func (r *RequestParameters) SetStripeAccount(value string)

SetStripeAccount sets the value for the `Stripe-Account` header.

func (*RequestParameters) SetVersion

func (r *RequestParameters) SetVersion(value string)

SetVersion sets the value for the `Stripe-Version` header.

type TracedTransport

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

TracedTransport is an http.RoundTripper that keeps track of the in-flight request and implements hooks to report HTTP tracing events this is a different RoundTripper implementation to stripe.verboseTransport and is not designed for Stripe API requests

func (*TracedTransport) DNSDone

func (t *TracedTransport) DNSDone(dnsInfo httptrace.DNSDoneInfo)

DNSDone will trace log each DNS lookup for the current request

func (*TracedTransport) GotConn

func (t *TracedTransport) GotConn(connInfo httptrace.GotConnInfo)

GotConn will trace log each connection for the current request

func (*TracedTransport) RoundTrip

func (t *TracedTransport) RoundTrip(req *http.Request) (*http.Response, error)

RoundTrip wraps http.DefaultTransport.RoundTrip to keep track of the current request

type WebhookEndpoint

type WebhookEndpoint struct {
	Application   string   `json:"application"`
	EnabledEvents []string `json:"enabled_events"`
	URL           string   `json:"url"`
	Status        string   `json:"status"`
}

WebhookEndpoint contains the data for each webhook endpoint

type WebhookEndpointList

type WebhookEndpointList struct {
	Data []WebhookEndpoint `json:"data"`
}

WebhookEndpointList contains the list of webhook endpoints for the account

func WebhookEndpointsList

func WebhookEndpointsList(ctx context.Context, baseURL, apiVersion, apiKey string, profile *config.Profile) WebhookEndpointList

WebhookEndpointsList returns all the webhook endpoints on a users' account

func WebhookEndpointsListWithClient

func WebhookEndpointsListWithClient(ctx context.Context, client stripe.RequestPerformer, apiVersion string, profile *config.Profile) WebhookEndpointList

WebhookEndpointsListWithClient returns all the webhook endpoints on a users' account