go-sfdc icon indicating copy to clipboard operation
go-sfdc copied to clipboard

go-sfdc is a library used to interface to Salesforce APIs using golang

go-sfdc

This is a golang library for interfacing with Salesforce APIs.

Getting Started

Installing

To start using GO-SFDC, install GO and run go get

go get -u github.com/g8rswimmer/go-sfdc

This will retrieve the library.

Usage

To use this library, the following will need to be done.

  • Create Salesforce credentials to properly authenticate with the Salesforce org
  • Configure
  • Open a session
  • Use the APIs
    • SObject APIs
    • SObject Collection APIs
    • SObject Tree API
    • SOQL APIs
    • Composite
    • Composite Batch
    • Bulk 2.0

Configuration

The configuration defines several parameters that can be used by the library. The configuration is used per session.

  • Credentials - this is an implementation of the credentials.Provider interface
  • Client - the HTTP client used by the APIs
  • Version - is the Salesforce version. Please refer to Salesforce documentation to make sure that APIs are supported in the version that is specified.

Example

config := sfdc.Configuration{
	Credentials: credentials.NewPasswordCredentials(creds),
	Client:      salesforceHTTPClient,
	Version:     44,
}

License

GO-SFDC source code is available under the MIT License