Crate rplaid

Source
Expand description

§Description

rplaid is an async client for the Plaid API. With minimal features, the client is meant to be extensible and lightweight. Additional features can be enabled to improve ergonomics of the API at the cost of additional dependencies.

The goal is to provide expressive bindings that provide sensible defaults where possible for ease of use.

See official API docs for more information about endpoints or specific products.

These bindings are not official Plaid bindings.

§Glossary

  • Item - A Item represents a connection to a single financial instution. Typically links are associated with a pair of credentials and an access_token. Items are associated to one or more accounts.

  • Link - Link is a client-side component that Plaid provides to link to accounts. See https://plaid.com/docs/link/#introduction-to-link for more information.

  • Account - An account is a financial account that is linked to an Item. An item, or financial institution, may have multiple accounts for a single user (e.g. a checking account and a credit account).

  • Product - Entities with services offered by Plaid, see https://plaid.com/docs/api/products/ for more information.

§Features

  • Idiomatic futures generator for easily reading multiple pages of transactions.
  • Extensible HttpClient interfaces supports multiple HTTP clients with minimal effort (surf, H1, and reqwest). The trait can also be implemented to have full control over the HTTP client used.
  • Rust types, including variant types, for most API return types.

§Create features

This crate provides a few features that make working with Plaid’s APIs more ergonomic. Without these features the crate works like a 1:1 translation of Plaid’s APIs.

  • streams - When enabled this will add a new method for consuming all transactions available from a future stream without having to worry about pagination or cursors.

  • decimal - When enabled currency amounts in response payloads will be parsed as rust_decimal::Decimal types for more correct use in computations.

§Limitations

Some endpoints are production specific or beta products and are not yet supported by the client.

For a breakdown of endpoint support visit: https://docs.google.com/spreadsheets/d/1xqUXdfllo37Rx5MVrQODbVqNQvuktiCVL5Uh8y9mYYw

Modules§

client
Exposes primary client type for sending requests to Plaid’s API.
model
Data types for entities returned by Plaid API endpoints.

Traits§

HttpClient
Re-exports HttpClient trait for implementing a custom HTTP client. An abstract HTTP client.