Go SDK

This guide explains how to interact with the API using the Go client.

---

Installation

go get github.com/fortisx/go-sdk

---

Initialization

package main

import (
    "fmt"
    "log"

    api "github.com/fortisx/go-sdk"
)

func main() {
    client := api.NewAPI("YOUR_API_KEY")

    res, err := client.Get("ping", nil)
    if err != nil {
        log.Fatal(err)
    }

    fmt.Println(res)
}

Constructor

func NewAPI(apiKey string) *API

Defaults:

• Base URL: https://api.fortisx.fi/v1

• Timeout: 10 seconds

Optional setters:

// Example of fluent-style configuration (optional feature)
import "time"

client := api.NewAPI("YOUR_API_KEY").
    WithBaseURL("https://api.fortisx.fi/v1").
    WithTimeout(10 * time.Second)

---

Methods

Method	Signature	Description
Get	Get(endpoint string, params map[string]string) (map[string]interface{}, error)	Performs a GET request
Post	Post(endpoint string, data map[string]interface{}) (map[string]interface{}, error)	Performs a POST request
Put	Put(endpoint string, data map[string]interface{}) (map[string]interface{}, error)	Performs a PUT request
Delete	Delete(endpoint string) (map[string]interface{}, error)	Performs a DELETE request

All methods automatically include the following headers:

Authorization: Bearer <API_KEY>
Accept: application/json

---

Error Handling

When a request fails, an APIError is returned. This struct implements the error interface.

type APIError struct {
    Status  int
    Message string
    Details map[string]interface{}
}

func (e *APIError) Error() string {
    return fmt.Sprintf("API error [%d]: %s", e.Status, e.Message)
}

Example:

res, err := client.Get("ping", nil)
if err != nil {
    if apiErr, ok := err.(*api.APIError); ok {
        log.Fatalf("API error [%d]: %s", apiErr.Status, apiErr.Message)
    }
    log.Fatalf("Unexpected error: %v", err)
}
fmt.Println(res)

---

Example: /ping Endpoint

package main

import (
    "fmt"
    "log"

    api "github.com/fortisx/go-sdk"
)

func main() {
    client := api.NewAPI("demo-key")

    res, err := client.Get("ping", nil)
    if err != nil {
        log.Fatal(err)
    }

    fmt.Println(res) // map[status:ok]
}