Getting Started

Copy page

Authentication

All Calcs.com GIS API requests require authentication using an API key. This ensures secure access to geospatial datasets and tracks usage.

API Key Authentication

How It Works

API keys are passed in the request headers:

Code
 
GET /gis/elevation?latitude=40.7128&longitude=-74.0060 HTTP/1.1
Host: api.Calcs.com
Authorization: Bearer YOUR_API_KEY_HERE

Obtaining an API Key

1. Contact Calcs.com - Reach out to our team to request API access
2. Receive Credentials - You'll receive an API key for your organization
3. Store Securely - Keep your API key confidential (use environment variables)

Making Authenticated Requests

Using cURL

Code
 
curl -X GET "https://api.Calcs.com/gis/elevation?latitude=40.7128&longitude=-74.0060" \
  -H "Authorization: Bearer YOUR_API_KEY"

Using JavaScript (Node.js)

Code
 
const apiKey = process.env.CALCS_API_KEY;

const response = await fetch(
  'https://api.calcs.com/gis/elevation?latitude=40.7128&longitude=-74.0060',
  {
    headers: {
      'Authorization': `Bearer ${apiKey}`
    }
  }
);

const data = await response.json();
console.log(data);

Using Python

Code
 
import os
import requests

api_key = os.environ.get('CALCS_API_KEY')
headers = {'Authorization': f'Bearer {api_key}'}

response = requests.get(
    'https://api.calcs.com/gis/elevation',
    params={'latitude': 40.7128, 'longitude': -74.0060},
    headers=headers
)

data = response.json()
print(data)

Best Practices

1. Environment Variables

Store API keys in environment variables, not in code.

2. Server-Side Only

Make API calls from your backend servers, not from browsers or mobile apps directly.

3. Use HTTPS Only

All API requests must use HTTPS.

Need Help?

Contact our support team:

• Email: [email protected]
• Support Portal: Calcs.com/support

---

Next: Quick Start Guide