README.md

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 github.com/namely/go-sfdc/v3

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

package main

import (
	"github.com/namely/go-sfdc/v3"
	"github.com/namely/go-sfdc/v3/credentials"
)

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

License

GO-SFDC source code is available under the MIT License