get

suspend fun HttpClient.get(urlString: String, policy: RequestPolicy): HttpResponse

Performs an HTTP GET request to urlString applying only policy.

This overload does not prepend any shard segment. Use it for already-qualified paths (for example, when the caller builds shards/{...}/...) or absolute URLs.

Return

The received HttpResponse.

Parameters

urlString

Relative or absolute URL/path to request.

policy

Per-request behavior flags (authentication/rate-limit handling).


suspend fun HttpClient.get(urlString: String, platform: Platform = Platform.STEAM, policy: RequestPolicy = DefaultRequestPolicy): HttpResponse

Performs an HTTP GET request to urlString using a Platform shard.

The request path is rewritten to: shards/{platform.path}/{urlString}

Prefer this overload for endpoints that are platform-scoped (players, matches, clans, mastery, etc.).

Return

The received HttpResponse.

Parameters

urlString

Endpoint-relative path (for example, players/{accountId}).

platform

Platform shard used when building the final request path.

policy

Per-request behavior flags. Defaults to DefaultRequestPolicy.


suspend fun HttpClient.get(urlString: String, platform: Platform = Platform.STEAM, policy: RequestPolicy = DefaultRequestPolicy, block: HttpRequestBuilder.() -> Unit = {}): HttpResponse

Performs an HTTP GET request to urlString using a Platform shard, and applies additional request customization via block.

The request path is rewritten to: shards/{platform.path}/{urlString}

This overload is useful when callers need to add query parameters, headers, or other request-level options while still using platform-scoped routing.

Return

The received HttpResponse.

Parameters

urlString

Endpoint-relative path to request.

platform

Platform shard used when building the final request path.

policy

Per-request behavior flags. Defaults to DefaultRequestPolicy.

block

Additional request customization applied to the HttpRequestBuilder.


suspend fun HttpClient.get(urlString: String, platformRegion: PlatformRegion = PlatformRegion.PC_SA, policy: RequestPolicy = DefaultRequestPolicy): HttpResponse

Performs an HTTP GET request to urlString using a PlatformRegion shard.

The request path is rewritten to: shards/{platformRegion.path}/{urlString}

Prefer this overload for endpoints that are region-scoped.

Return

The received HttpResponse.

Parameters

urlString

Endpoint-relative path to request.

platformRegion

Platform-region shard used when building the final request path.

policy

Per-request behavior flags. Defaults to DefaultRequestPolicy.