Authentication

import hashlib
import hmac
import datetime
from collections import OrderedDict
from urllib.parse import urlencode

PRIVATE_KEY = "your_private_key"
PUBLIC_KEY = "your_public_key"

# Collect all request parameters plus Key and Timestamp
params = {
    "Key": PUBLIC_KEY,
    "Timestamp": int(datetime.datetime.utcnow().timestamp()),
    "category": 5,  # any query/body params for this request
}

# Sort alphabetically and URL-encode
params_to_sign = OrderedDict(sorted(params.items()))
encoded_params = urlencode(params_to_sign).encode("utf-8")
encoded_private_key = PRIVATE_KEY.encode("utf-8")

# Compute HMAC-SHA512
hmac_signature = hmac.new(encoded_private_key, encoded_params, hashlib.sha512).hexdigest()

# Build headers
headers = {
    "Key": PUBLIC_KEY,
    "Timestamp": str(params["Timestamp"]),
    "HMAC": hmac_signature,
}

# Make the request
import requests
response = requests.get(
    "https://api.futuur.com/v2.0/events/",
    params={"category": 5},
    headers=headers,
)

const crypto = require("crypto");

const PRIVATE_KEY = "your_private_key";
const PUBLIC_KEY = "your_public_key";

function signRequest(requestParams = {}) {
  const timestamp = Math.floor(Date.now() / 1000);

  // Combine request params with auth params
  const params = { ...requestParams, Key: PUBLIC_KEY, Timestamp: timestamp };

  // Sort alphabetically and URL-encode
  const sortedKeys = Object.keys(params).sort();
  const encoded = sortedKeys
    .map((k) => `${encodeURIComponent(k)}=${encodeURIComponent(params[k])}`)
    .join("&");

  // Compute HMAC-SHA512
  const signature = crypto
    .createHmac("sha512", PRIVATE_KEY)
    .update(encoded)
    .digest("hex");

  return {
    Key: PUBLIC_KEY,
    Timestamp: String(timestamp),
    HMAC: signature,
  };
}

// Example: GET /events/?category=5
const headers = signRequest({ category: 5 });

fetch("https://api.futuur.com/v2.0/events/?category=5", { headers })
  .then((res) => res.json())
  .then(console.log);

# Pre-compute the HMAC signature using Python or another tool,
# then pass the headers directly.

curl https://api.futuur.com/v2.0/events/?category=5 \
  -H "Key: YOUR_PUBLIC_KEY" \
  -H "Timestamp: 1234567890" \
  -H "HMAC: YOUR_COMPUTED_SIGNATURE"