Getting started

Install the SDK, create a client and send your first request in a few minutes.

Installation

The SDK supports Node.js 18+ and Python 3.9+. Install the package for your language:

npm install @maplefield/sdk
# or
pip install maplefield-sdk

Every request is authenticated with an API key. Keep keys on the server side and never ship them to browsers.

import { Client } from "@maplefield/sdk";

const client = new Client({
  apiKey: process.env.API_KEY,
  region: "eu-central",
});

Requests are retried automatically on network errors and 429 responses, with exponential backoff up to three attempts.

const projects = await client.projects.list({ limit: 20 });

for (const project of projects.data) {
  console.log(project.id, project.name);
}

List endpoints return a page object with data and a cursor for the next page — see Pagination.