Enum DcRegion 

pub enum DcRegion {
    Ap,
    Us,
}

Data center region used for API gateway routing.

Independent of [is_cn]: that picks the *.longbridge.cn vs *.longbridge.com host (mainland acceleration), while this selects which data center (us/ap) the gateway sources data from.

Variants

Ap

Asia-Pacific data center (ap). The gateway default.

Us

US data center (us).

Implementations

impl DcRegion

pub fn from_credential(credential: &str) -> DcRegion

Derive the region from a single credential’s prefix.

Longbridge credentials — the OAuth access token, and the legacy API-key app_key / app_secret / access_token — are prefixed with their data center: us_… for the US data center, ap_… for Asia-Pacific. A us_ prefix maps to DcRegion::Us; everything else — including ap_-prefixed and unprefixed credentials — maps to DcRegion::Ap, matching the gateway default. A leading Bearer is tolerated so an Authorization value can be passed directly.

pub fn from_credentials(credentials: &[&str]) -> DcRegion

Derive the region from a set of credentials, returning DcRegion::Us if any of them carries the us_ prefix.

Used for legacy API-key auth, where the app_key, app_secret, and access_token all carry the region prefix.

pub fn as_str(self) -> &'static str

The DC_REGION_HEADER value for this region ("us" or "ap").

pub fn allows(self, required: DcRegion) -> bool

Whether this session may reach an API limited to required.

true when the session’s region matches the API’s required region; callers short-circuit with a unified error when it is false.

pub fn strip_region_prefix(credential: &str) -> &str

Strip any leading Bearer from a credential.

Region prefixes (hk_m_, us_m_, ap_m_, …) are routing metadata consumed by [from_credential] to derive the DC_REGION_HEADER. The gateway accepts the full prefixed token and routes via the header, so no region prefix is stripped — only Bearer is removed.

Trait Implementations

impl Clone for DcRegion

fn clone(&self) -> DcRegion

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for DcRegion

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Display for DcRegion

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Human-facing uppercase name (AP/US), for error messages and display. The lowercase DC_REGION_HEADER value is as_str.

impl PartialEq for DcRegion

fn eq(&self, other: &DcRegion) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for DcRegion

impl Eq for DcRegion

impl StructuralPartialEq for DcRegion