SDKs & Libraries

Quick Start

Initialize the client with your API key. The SDK handles token rotation, request signing, and exponential backoff automatically.

import { GitClient } from '@git/sdk-js';

// Initialize with environment variable
const client = new GitClient({
  apiKey: process.env.GIT_API_KEY,
  environment: 'production'
});

// List repositories with pagination
const repos = await client.repos.list({
  limit: 20,
  filter: 'active'
});

console.log(repos.data);

import os
from git_sdk import GitClient

# Initialize with environment variable
client = GitClient(
    api_key=os.environ["GIT_API_KEY"],
    environment="production"
)

# List repositories with pagination
repos = await client.repos.list(
    limit=20,
    filter="active"
)

print(repos.data)

package main

import (
    "os"
    "log"
    "gitlab.com/git/sdk-go"
)

func main() {
    client := sdk.NewClient(os.Getenv("GIT_API_KEY"))

    repos, err := client.Repos.List(context.Background(), &sdk.RepoFilter{
        Limit:  20,
        Status: "active",
    })
    if err != nil {
        log.Fatal(err)
    }

    fmt.Println(repos.Data)
}

Authentication

All SDKs support multiple authentication methods:

• API Keys - Standard server-to-server communication. Scoped by permission.
• Service Tokens - Short-lived tokens generated via OAuth2 flow for end-user apps.
• Webhook Signing - HMAC-SHA256 verification for incoming event payloads.
• AWS/GCP/Azure IAM - Direct cloud provider authentication for hosted deployments.

Versioning & Support Policy

We follow Semantic Versioning strictly. Breaking changes only occur in major releases. Minor and patch releases are backward-compatible.

Upgrade Path: Use the @git/migrate CLI tool to automatically refactor deprecated method calls and update configuration schemas.

Need Help?

Our SDKs are open-source and maintained by the core engineering team. Report bugs, request features, or get help implementing.