Docs / getting started/ quickstart

title: Quickstart

description: Make your first Wontopos API call in under 5 minutes.

Quickstart

Get from zero to your first API response in minutes.

Time to first call

Most developers complete this guide in under 5 minutes.

Prerequisites

  • A Wontopos account (sign up free)
  • One of: Node.js 18+, Python 3.8+, or Go 1.21+
  • Basic familiarity with REST APIs

Get started

Create your account

Sign up at platform.wontopos.com and verify your email.

Generate an API key

Navigate to Settings → API Keys → Create new key.

Keep your key secure

Never commit API keys to version control. Use environment variables.
export WONTOPOS_API_KEY="sk_live_your_key_here"

Make your first call

Choose your language and run the example below.

# cURL
curl https://api.wontopos.com/v1/marketplace/apis 
  -H "Authorization: Bearer $WONTOPOS_API_KEY" 
  -G -d limit=5
// JavaScript
import Wontopos from "@wontopos/sdk";

const client = new Wontopos(process.env.WONTOPOS_API_KEY);

const apis = await client.marketplace.list({ limit: 5 });
console.log(apis.data);
# Python
import wontopos

client = wontopos.Client(api_key=os.environ["WONTOPOS_API_KEY"])

apis = client.marketplace.list(limit=5)
print(apis.data)
// Go
package main

import (
    "context"
    "fmt"
    "log"
    "os"

    wontopos "github.com/wontopos/wontopos-go"
)

func main() {
    client := wontopos.NewClient(os.Getenv("WONTOPOS_API_KEY"))

    apis, err := client.Marketplace.List(context.Background(), wontopos.MarketplaceListParams{
        Limit: wontopos.Int(5),
    })
    if err != nil {
        log.Fatal(err)
    }
    for _, api := range apis.Data {
        fmt.Println(api.Name)
    }
}

Expected response

A successful call returns a JSON payload like this:

{
  "data": [
    {
      "id": "api_01abc",
      "name": "Geocoding API",
      "status": "active",
      "version": "v2"
    }
  ],
  "has_more": true
}

Sandbox available

Use the sandbox base URL for testing without affecting production data. See [Environments](/docs/getting-started/environments).

Next steps