API Authentication Guide

Getting Started

All requests to the suicixde.xyz API require authentication using an API key. Follow the steps below to get started.

Step 1: Register for an Account

Create a free account on suicixde.xyz. You'll get instant access to your API dashboard and receive your first API key.

No credit card required - Start with the Free tier and upgrade anytime.

Step 2: Copy Your API Key

In your dashboard, find your API key under "API Keys". Each key has a unique identifier that you'll use to authenticate requests.

⚠️ Keep your API key secret - Never commit it to public repositories or share it with anyone.

Step 3: Authenticate Requests

Include your API key in the Authorization header of every API request:

                GET /api/v1/geoip?ip=8.8.8.8 HTTP/1.1
Host: suicixde.xyz
Authorization: Bearer YOUR_API_KEY
            

Authentication Methods

Bearer Token (Recommended)

Authorization: Bearer YOUR_API_KEY

Use this method for most requests. Replace YOUR_API_KEY with your actual API key.

Query Parameter

https://suicixde.xyz/api/v1/geoip?ip=1.1.1.1&api_key=YOUR_API_KEY

Note: Query parameter authentication should only be used for non-sensitive operations. Always prefer Bearer tokens for security.

Code Examples

Python

            import requests

headers = {
    'Authorization': 'Bearer YOUR_API_KEY'
}

response = requests.get(
    'https://suicixde.xyz/api/v1/geoip?ip=8.8.8.8',
    headers=headers
)

print(response.json())
        

JavaScript/Node.js

            const fetch = require('node-fetch');

const headers = {
    'Authorization': 'Bearer YOUR_API_KEY'
};

fetch('https://suicixde.xyz/api/v1/geoip?ip=8.8.8.8', {
    headers: headers
})
.then(r => r.json())
.then(data => console.log(data))
        

cURL

            curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://suicixde.xyz/api/v1/geoip?ip=8.8.8.8
        

PHP

            (
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://suicixde.xyz/api/v1/geoip?ip=8.8.8.8');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_KEY'
]);
$response = curl_exec($ch);
echo $response;
)"
        

Error Handling

Invalid API Key

            {
  "error": "Invalid API key",
  "code": 401,
  "message": "Authentication failed"
}
        

Rate Limit Exceeded

            {
  "error": "Rate limit exceeded",
  "code": 429,
  "message": "Too many requests. Please try again later.",
  "retry_after": 3600
}
        

Best Practices

Store API keys in environment variables, not in code
Rotate API keys regularly (at least quarterly)
Use HTTPS for all API requests (required)
Implement exponential backoff for retries
Monitor your API usage for unusual activity
Use separate API keys for different applications
Revoke compromised keys immediately

Support

Need help? Check our FAQ or contact us at support@suicixde.xyz