Struct SocrataClient 

pub struct SocrataClient { /* private fields */ }

A client for the Socrata Open Data API (SODA).

Implementations

impl SocrataClient

pub fn new(base_url: &str, app_token: Option<String>) -> Self

Creates a new SocrataClient.

Arguments

• base_url - The base domain of the Socrata instance (e.g., “https://www.datos.gov.co”)
• app_token - Optional Socrata App Token for higher rate limits.

pub async fn fetch<T: DeserializeOwned>( &self, dataset_id: &str, limit: u32, offset: u32, order: Option<&str>, where_clause: Option<&str>, ) -> Result<Vec<T>, SocrataError>

Fetch data from a specific dataset ID using SODA API.

Arguments

• dataset_id - The 4x4 ID of the dataset (e.g. “jbjy-vk9h”)
• limit - Number of records to return
• offset - Number of records to skip
• order - SoQL order clause (e.g. “date DESC”)
• where_clause - Optional SoQL where clause

pub async fn get_all<T: DeserializeOwned>( &self, dataset_id: &str, order: Option<&str>, where_clause: Option<&str>, ) -> Result<Vec<T>, SocrataError>

Fetch ALL data from a dataset, automatically paginating through results.

This method handles pagination internally and returns all records. For very large datasets, consider using fetch() with explicit pagination.

Arguments

• dataset_id - The 4x4 ID of the dataset
• order - Optional SoQL order clause
• where_clause - Optional SoQL where clause

pub async fn get_metadata( &self, dataset_id: &str, ) -> Result<DatasetMetadata, SocrataError>

Retrieve metadata about a specific dataset.

Arguments

• dataset_id - The 4x4 ID of the dataset

pub async fn datasets( &self, limit: u32, offset: u32, ) -> Result<Vec<CatalogResource>, SocrataError>

List all datasets in the domain.

Uses the Socrata Catalog API to discover available datasets.

Arguments

• limit - Maximum number of datasets to return (0 = all)
• offset - Number of datasets to skip