Struct TokensClient 

pub struct TokensClient { /* private fields */ }

Access to the /v1/gate/tokens endpoints.

Obtain via Gate::tokens.

Implementations

impl TokensClient

pub async fn create( &self, params: CreateTokenParams, ) -> Result<AccessToken, Error>

Issue a short-lived access token for a subject.

Maps to POST /v1/gate/tokens. The API key is sent in the request body rather than the Authorization header.

Example

use nautilus_rs::{Gate, CreateTokenParams};

let gate = Gate::new("vrn_gate_live_sk_…");
let token = gate.tokens().create(CreateTokenParams {
    subject: "idn_alice".into(),
    scopes: Some(vec!["read:profile".into()]),
    ttl_seconds: Some(900),
}).await?;
println!("expires at {}", token.expires_at);

pub async fn introspect(&self, access_token: &str) -> Result<TokenInfo, Error>

Validate an access token and retrieve its claims.

Maps to POST /v1/gate/tokens/introspect. Check TokenInfo::active to determine whether the token is still valid.

Example

use nautilus_rs::Gate;

let gate = Gate::new("vrn_gate_live_sk_…");
let info = gate.tokens().introspect("eyJ…").await?;
if info.active {
    println!("valid token for {}", info.subject);
}