Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

remote

package module

Go to main page

Versions in this module

v0

v0.3.0

Jul 9, 2026

Changes in this version

type Client

+ func (c *Client) RawRequest(ctx context.Context, req RawRequest) (*RawResponse, error)

type Manager

+ func (m *Manager) CallRaw(ctx context.Context, serviceID string, req RawRequest) (*RawResponse, error)

type Option

+ func WithClientCertificate(cert tls.Certificate) Option

+ func WithClientCertificateFiles(certFile, keyFile string) Option

+ type RawRequest struct

+ Body []byte

+ ContentType string

+ Headers map[string]string

+ Method string

+ Path string

+ Retry *RetryConfig

+ type RawResponse struct

+ Body []byte

+ Header http.Header

+ StatusCode int

type ServiceConfig

+ TLS *TLSSettings

+ type TLSSettings struct

+ ClientCertFile string

+ ClientKeyFile string

v0.2.0

Jun 18, 2026

v0.1.0

Jun 16, 2026

Changes in this version

+ var DefaultRetryConfig = RetryConfig

+ var ErrBadRequest = errors.New("remote: invalid request")

+ var ErrNotFound = errors.New("remote: resource not found")

+ var ErrRequestFailed = errors.New("remote: request failed")

+ var ErrServiceUnavailable = errors.New("remote: service unavailable")

+ var ErrTimeout = errors.New("remote: request timed out")

+ var ErrUnauthorized = errors.New("remote: unauthorized access")

+ type AuthConfig struct

+ Options json.RawMessage

+ Type string

+ type Client struct

+ func NewClient(baseURL string, opts ...Option) *Client

+ func (c *Client) Do(ctx context.Context, method, path string, body io.Reader, ...) (*http.Response, error)

+ func (c *Client) JSONRequest(ctx context.Context, req Request, response interface{}) error

+ type Manager struct

+ func NewManager() *Manager

+ func (m *Manager) Call(ctx context.Context, serviceID string, req Request, response interface{}) error

+ func (m *Manager) GetClient(id string) (*Client, error)

+ func (m *Manager) GetClientByURL(rawURL string) (*Client, string, error)

+ func (m *Manager) ListServices() []string

+ func (m *Manager) LoadServices(filePath string) error

+ type Option func(*Client)

+ func WithAuthenticator(a auth.Authenticator) Option

+ func WithTimeout(timeout time.Duration) Option

+ type Registry struct

+ Services []ServiceConfig

+ Version string

+ type RemoteError struct

+ Message string

+ StatusCode int

+ Wrapped error

+ func (e *RemoteError) Error() string

+ func (e *RemoteError) Unwrap() error

+ type Request struct

+ Body any

+ Headers map[string]string

+ Method string

+ Path string

+ Query url.Values

+ Retry *RetryConfig

+ type RetryConfig struct

+ InitialBackoff time.Duration

+ MaxBackoff time.Duration

+ MaxRetries int

+ RetryableStatus []int

+ type ServiceConfig struct

+ Auth *AuthConfig

+ ID string

+ Timeout string

+ URL string