Send your first API request

After setting up your development environment with the @gospace-ai/api SDK, you can make your first API call to the /system/v1/country endpoint to retrieve a list of available countries supported by gospace. This endpoint provides country IDs required for creating locations.

Node.js

Create a Script

Create a JavaScript file to list available countries:javascript

// list_countries.js
const { GospaceClient } = require('@gospace-ai/api');
require('dotenv').config();

async function listCountries() {
  try {
    const client = new GospaceClient({ api_key: process.env.GOSPACE_API_KEY || '' });
    const countries = await client.system.listCountries();
    console.log('Available countries:', countries.data);
  } catch (error) {
    console.error('Error listing countries:', error);
  }
}

listCountries();

Run the Script

Ensure your .env file contains a valid GOSPACE_API_KEY, then run:bash

node list_countries.js

You should see a list of countries printed, such as:json

Available countries: [
  { id: 'UK', name: 'United Kingdom' },
  { id: 'US', name: 'United States' }
]

Note: The @gospace-ai/api SDK supports TypeScript for type-safe development. To use TypeScript, rename the file to list_countries.ts, install ts-node (npm install ts-node --save-dev), and run with npx ts-node list_countries.ts. See developer.gospace.com for TypeScript setup and API documentation.