Demo API (Scalar Galaxy)

This library provides convenient access to the Demo API (Scalar Galaxy) from Ruby.

The full API of this library can be found in api.md.

Installation
Usage
API Reference
Authentication
Errors
Client Options
Request Options
Retries and Timeouts
Helpers
Requirements

Installation

Add the gem to your application's Gemfile:

gem "amritk-galaxy-staging", "~> 0.2.0" # x-release-please-version

Or install it directly:

gem install amritk-galaxy-staging

Usage

require "amritk-galaxy-staging"

client = DemoApiScalarGalaxy::Client.new(
  bearer_auth: ENV["BEARER_AUTH"], # defaults to the BEARER_AUTH env var
)

response = client.planets.list({ limit: 10, offset: 0 })

puts response.inspect

The examples in the following sections assume a client configured as shown above.

See the API reference for every available operation.

Authentication

Pass credentials to the generated client constructor. Environment variables are read automatically when supported by the target runtime.

Option	Type	Default	Description
`bearer_auth`	`String \	nil`	-
`basic_auth_username`	`String \	nil`	-
`basic_auth_password`	`String \	nil`	-
`api_key_header`	`String \	nil`	-
`api_key_query`	`String \	nil`	-
`api_key_cookie`	`String \	nil`	-
`o_auth2`	`String \	nil`	-
`open_id_connect`	`String \	nil`	-

Declared schemes:

bearerAuth bearer token
basicAuth basic authentication
apiKeyHeader API key in header X-API-Key
apiKeyQuery API key in query api_key
apiKeyCookie API key in cookie api_key
oAuth2 OAuth2/OpenID Connect
openIdConnect OAuth2/OpenID Connect

Errors

Non-success responses throw generated API errors. Error objects expose status, headers, response body, and request metadata where the target runtime supports it.

begin
  response = client.planets.list({ limit: 10, offset: 0 })

  puts response.inspect
rescue DemoApiScalarGalaxy::Errors::APIError => error
  puts "#{error.status}: #{error.message}"
  raise
end

Documented error statuses: 400, 401, 403, 404, 409, 422.

Client Options

Configure the generated client by setting any of these options when you create it.

require "amritk-galaxy-staging"

client = DemoApiScalarGalaxy::Client.new(
  timeout: 60.0,
  max_retries: 2,
)

Option	Type	Default	Description
`bearer_auth`	`String \	nil`	`ENV["BEARER_AUTH"]`
`basic_auth_username`	`String \	nil`	`ENV["BASIC_AUTH_USERNAME"]`
`basic_auth_password`	`String \	nil`	`ENV["BASIC_AUTH_PASSWORD"]`
`api_key_header`	`String \	nil`	`ENV["API_KEY_HEADER"]`
`api_key_query`	`String \	nil`	`ENV["API_KEY_QUERY"]`
`api_key_cookie`	`String \	nil`	`ENV["API_KEY_COOKIE"]`
`o_auth2`	`String \	nil`	`ENV["O_AUTH2"]`
`open_id_connect`	`String \	nil`	`ENV["OPEN_ID_CONNECT"]`
`webhook_secret`	`String \	nil`	`ENV["OFFICIAL_GALAXY_TESTING_WEBHOOK_SECRET"]`
`environment`	`:production \	:responds_with_your_request_data \	nil`
`base_url`	`String \	nil`	`ENV["OFFICIAL_GALAXY_TESTING_BASE_URL"]`
`max_retries`	`Integer`	`2`	Max number of retries to attempt after a failed retryable request.
`timeout`	`Float`	`60.0`	Seconds to wait for a response before timing out.
`initial_retry_delay`	`Float`	`0.5`	Seconds to wait before the first retry; later retries back off exponentially.
`max_retry_delay`	`Float`	`8.0`	Upper bound, in seconds, on the delay between retries.

Request Options

Option	Type	Default	Description
`idempotency_key`	`String`	-	Idempotency key for one request, sent when the SDK configures an idempotency header.
`extra_query`	`Hash`	-	Additional query parameters for one request.
`extra_headers`	`Hash`	-	Additional headers for one request.
`extra_body`	`Hash`	-	Additional body fields for one request.
`max_retries`	`Integer`	-	Override retry count for one request.
`timeout`	`Float`	-	Override timeout for one request.

Retries and Timeouts

Generated clients support request timeouts and retry temporary failures such as network errors, 408, 409, 429, and 5xx responses. Retry delays honor Retry-After headers when present. Tune the retry and timeout client options shown above, or override them per request.

Helpers

Every model is a BaseModel: pass a plain hash or a model instance, and read decoded values back as attributes.
The gem ships rbi/ and sig/ trees, so Sorbet and Steep type-check calls into the SDK.

Requirements

Ruby >= 3.2