xergo

A simple oauth2 client for the Xero accounting API, handling authorised and authenticated HTTP requests, as specified in RFC 6749.

It can additionally grant authorization with Bearer JWT and handle the automatic refreshing of bearer tokens.

It also handles idempotency, sending the Idempotency-Key header along with POST, PUT and PACTH requests, ensuring that resources are not duplicated.

Installation

go get github.com/Koroutine/xergo@latest

Usage

import (
  "github.com/Koroutine/xergo/pkg/xero"
)

func main() {
  	// Setup your scopes, matching you OAuth client setup.
	// https://developer.xero.com/documentation/guides/oauth2/scopes
	scopes := []string{"accounting.contacts", "accounting.attachments", "accounting.transactions"}

	ctx := context.Background()

	client, err := xero.NewClient(
		ctx,
		"https://api.xero.com",
		xero.OAuth2ClientCrendentials{
			ClientId:     "<YOUR_XERO_CLIENT_ID>",
			ClientSecret: "<YOUR_XERO_CLIENT_SECRET>",
		},
		xero.Params{
			TenantId: "<YOUR_XERO_TENANT_ID>",
		},
		scopes,
	)
  
  	// Oh, no.
	if err != nil {
		fmt.Println("Error creating Xero client:", err)
		return
	}

	// Get all invoices for the organisation attached to your OAuth client (or Tenant Id).
	_, err = client.GetInvoices()

	if err != nil {
		fmt.Println("Error getting invoices:", err)
		return
	}
}