Struct ApiClient 

pub struct ApiClient { /* private fields */ }

API client for Scouting.org. Clone is cheap - both reqwest::Client and token use Arc internally.

Implementations

impl ApiClient

pub fn new() -> Result<Self>

Create a new API client

pub fn set_token(&mut self, token: impl Into<Arc<String>>)

Set the bearer token for authenticated requests. Accepts any type that can be converted to Arc for efficient sharing.

pub fn with_token(&self, token: Arc<String>) -> Self

Create a new ApiClient with the given token, sharing the connection pool. This is very efficient - both the client and token are Arc-wrapped, so cloning is just incrementing reference counts.

pub async fn authenticate( &self, username: &str, password: &str, ) -> Result<SessionData>

Authenticate with the API and return session data

pub async fn fetch_youth(&self, org_guid: &str) -> Result<Vec<Youth>>

Fetch all youth members for the organization

pub async fn fetch_adults(&self, org_guid: &str) -> Result<Vec<Adult>>

Fetch all adult leaders for the organization

pub async fn fetch_parents(&self, org_guid: &str) -> Result<Vec<Parent>>

Fetch all parents of youth members in the organization

pub async fn fetch_patrols(&self, org_guid: &str) -> Result<Vec<Patrol>>

Fetch all patrols (sub-units) in the organization

pub async fn fetch_advancement_dashboard( &self, org_guid: &str, ) -> Result<AdvancementDashboard>

Fetch advancement dashboard summary for the organization

pub async fn fetch_ready_to_award( &self, org_guid: &str, ) -> Result<Vec<ReadyToAward>>

Fetch list of advancements ready to be awarded

pub async fn fetch_youth_ranks(&self, user_id: i64) -> Result<Vec<RankProgress>>

Fetch rank progress for a specific youth member

pub async fn fetch_youth_merit_badges( &self, user_id: i64, ) -> Result<Vec<MeritBadgeProgress>>

Fetch merit badge progress for a specific youth member

pub async fn fetch_youth_leadership( &self, user_id: i64, ) -> Result<Vec<LeadershipPosition>>

Fetch leadership position history for a specific youth member

pub async fn fetch_youth_awards(&self, user_id: i64) -> Result<Vec<Award>>

Fetch awards for a specific youth member

pub async fn fetch_rank_requirements( &self, user_id: i64, rank_id: i64, ) -> Result<Vec<RankRequirement>>

Fetch requirements for a specific rank for a youth member

pub async fn fetch_badge_requirements_only( &self, user_id: i64, badge_id: i64, ) -> Result<(Vec<MeritBadgeRequirement>, Option<String>)>

Fetch badge requirements only (no counselor info). Single API call. Use this for bulk/offline caching where counselor data isn’t needed.

pub async fn fetch_badge_requirements( &self, user_id: i64, badge_id: i64, ) -> Result<(Vec<MeritBadgeRequirement>, Option<String>, Option<CounselorInfo>)>

Fetch badge requirements, returns (requirements, version, counselor)

pub async fn fetch_merit_badge_catalog( &self, ) -> Result<Vec<MeritBadgeCatalogEntry>>

Fetch all merit badges from the catalog (not youth-specific)

pub async fn fetch_events(&self, user_id: i64) -> Result<Vec<Event>>

Fetch events for a date range around the current date

pub async fn fetch_event_detail(&self, event_id: i64) -> Result<Event>

Fetch detailed event info including full invited_users with RSVP data

pub async fn fetch_event_guests(&self, event_id: i64) -> Result<Vec<EventGuest>>

Fetch guest list for a specific event

pub async fn fetch_key3(&self, org_guid: &str) -> Result<Key3Leaders>

Fetch Key 3 leaders for the organization

pub async fn fetch_unit_pin(&self, org_guid: &str) -> Result<UnitInfo>

Fetch unit registration PIN info (includes website and charter info)

pub async fn fetch_org_profile(&self, org_guid: &str) -> Result<OrgProfile>

Fetch organization profile

pub async fn fetch_commissioners( &self, org_guid: &str, ) -> Result<Vec<Commissioner>>

Fetch assigned commissioners for a unit

Trait Implementations

impl Clone for ApiClient

fn clone(&self) -> ApiClient

Returns a duplicate of the value.

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

Performs copy-assignment from source.