RustSF
Rust Salesforce API SDK
This crate to supports the Salesforce APIs:
- Rest API, version 67.0 (latest, Summer 2028), enabled via the feature
rest-api - Bulk API v1
- Bulk API v2
- Streaming API
These APIs are not yet implemented, but high on the list. If you are interested in contributing, or want to speed up the development, please go to Discussions and leave a message.
- Tooling API
- Metadata API
- CPQ API
- Heroku Platform API
- Streaming API
Forked from rustforce and from tance77, for the rustforce repo seemed to be abandoned. The rustforce repo also lacked some important features and had some design flows around API versioning.
Usage
[]
= { = "0.0.2", = ["rest-api"] }
use ;
use Deserialize;
use env;
async
Authentication
Username Password Flow (OAuth2)
let mut client = new;
client.set_client_id;
client.set_client_secret;
client.login_with_credential.await?;
SOAP Login
let mut client = new;
client.login_by_soap.await?;
Using an Existing Access Token
let mut client = new;
client.set_instance_url;
client.set_access_token;
SFDX AUTH URL
let mut client = new;
client.login_by_sfdx_auth_url.await?;
Refresh Token
client.set_refresh_token;
client.refresh.await?;
REST API
All REST API methods are accessed through RestApi:
let mut api = new;
Query Records
let res: = api.query.await?;
Examples: Query, Query All, Query More
Find By Id
Finds a single record by its Salesforce ID. Example:
let account = api..await?;
CRUD Record operations
let account = Account ;
let res = api.create_sobject.await?;
let res = api.create.await?;
Examples:
Update Record
api.update.await?;
Upsert Record
let res = api.upsert.await?;
println!; // 200 = updated, 201 = created
Delete Record
api.destroy.await?;
Describe Global
use DescribeGlobalResponse;
let res: DescribeGlobalResponse = api.describe_global.await?;
Describe SObject
use DescribeResponse;
let res: DescribeResponse = api.describe.await?;
Versions
use VersionResponse;
let versions: = api.versions.await?;
Search (SOSL)
use SearchResponse;
let res: SearchResponse = api.search_sosl.await?;
Bulk API v1
use BulkApi;
let mut bulk = new;
let res = bulk.create_job.await?;
Bulk API v2
use BulkApiV2;
let mut bulk = new;
let res = bulk.create_job.await?;