LOCURA API

curl -X GET "https://hub.locura.tech/api/v1/clients" \
  -H "Authorization: Bearer lk_live_abc123def456ghi789jkl012mno345"

{
  "type": "https://api.locura.tech/errors/rate-limit-exceeded",
  "title": "Rate limit exceeded",
  "status": 429,
  "detail": "You have exceeded 60 requests per minute. Please retry after 23 seconds.",
  "instance": "/api/v1/clients",
  "request_id": "req_a1b2c3d4e5f6",
  "retry_after": 23
}

{
  "type": "https://api.locura.tech/errors/validation-error",
  "title": "Validation Error",
  "status": 422,
  "detail": "Field 'email' must be a valid email address.",
  "instance": "/api/v1/suppliers",
  "request_id": "req_x7y8z9a0b1c2"
}

curl "https://hub.locura.tech/api/v1/clients?page=2&per_page=25" \
  -H "Authorization: Bearer lk_live_abc123def456"

{
  "data": [
    { "id": "cli_abc123", "name": "Acme Corp", "nip": "1234567890" }
  ],
  "pagination": {
    "page": 2,
    "per_page": 25,
    "total": 87
  },
  "links": {
    "next": "/api/v1/clients?page=3&per_page=25",
    "prev": "/api/v1/clients?page=1&per_page=25"
  }
}

{
  "id": "evt_a1b2c3d4e5",
  "type": "avisator.booking.created",
  "timestamp": "2026-03-24T10:00:00.000Z",
  "data": {
    "booking_id": "bk_e5f6g7h8",
    "location_id": "loc_a1b2c3d4",
    "dock_id": "dock_x1y2z3",
    "supplier_id": "sup_m1n2o3p4",
    "date": "2026-03-25",
    "start_time": "08:00"
  }
}

const crypto = require('crypto');

function verifyWebhookSignature(payload, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(payload, 'utf8')
    .digest('hex');

  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expected)
  );
}

// In your Express handler:
app.post('/webhooks/locura', (req, res) => {
  const signature = req.headers['x-locura-signature'];
  const isValid = verifyWebhookSignature(
    JSON.stringify(req.body),
    signature,
    process.env.LOCURA_WEBHOOK_SECRET
  );

  if (!isValid) {
    return res.status(401).json({ error: 'Invalid signature' });
  }

  // Process the event
  const event = req.body;
  console.log('Received event:', event.type);

  res.status(200).json({ received: true });
});

import hmac
import hashlib
import os
from flask import Flask, request, jsonify

app = Flask(__name__)

def verify_webhook_signature(payload, signature, secret):
    expected = hmac.new(
        secret.encode('utf-8'),
        payload.encode('utf-8'),
        hashlib.sha256
    ).hexdigest()
    return hmac.compare_digest(signature, expected)

@app.route('/webhooks/locura', methods=['POST'])
def handle_webhook():
    signature = request.headers.get('X-Locura-Signature')
    is_valid = verify_webhook_signature(
        request.get_data(as_text=True),
        signature,
        os.environ['LOCURA_WEBHOOK_SECRET']
    )

    if not is_valid:
        return jsonify({'error': 'Invalid signature'}), 401

    event = request.get_json()
    print(f"Received event: {event['type']}")

    return jsonify({'received': True}), 200

# List all clients
curl "https://hub.locura.tech/api/v1/clients" \
  -H "Authorization: Bearer lk_live_abc123def456ghi789jkl012mno345"

# Search for a specific client
curl "https://hub.locura.tech/api/v1/clients?search=Acme&per_page=5" \
  -H "Authorization: Bearer lk_live_abc123def456ghi789jkl012mno345"

import requests

API_KEY = "lk_live_abc123def456ghi789jkl012mno345"
BASE_URL = "https://hub.locura.tech/api/v1"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

# List clients
response = requests.get(f"{BASE_URL}/clients", headers=headers)
data = response.json()

for client in data["data"]:
    print(f"{client['name']} (NIP: {client['nip']})")

print(f"Total: {data['pagination']['total']} clients")

const API_KEY = 'lk_live_abc123def456ghi789jkl012mno345';
const BASE_URL = 'https://hub.locura.tech/api/v1';

async function listClients() {
  const response = await fetch(`${BASE_URL}/clients`, {
    headers: {
      'Authorization': `Bearer ${API_KEY}`,
      'Content-Type': 'application/json'
    }
  });

  const { data, pagination } = await response.json();

  data.forEach(client => {
    console.log(`${client.name} (NIP: ${client.nip})`);
  });

  console.log(`Total: ${pagination.total} clients`);
}

listClients();

# Step 1: Check available slots
curl "https://avisator.locura.tech/api/v1/slots?location_id=loc_a1b2c3d4&date=2026-03-25" \
  -H "Authorization: Bearer lk_live_abc123def456"

# Step 2: Create the booking
curl -X POST "https://avisator.locura.tech/api/v1/bookings" \
  -H "Authorization: Bearer lk_live_abc123def456" \
  -H "Content-Type: application/json" \
  -d '{
    "location_id": "loc_a1b2c3d4",
    "dock_id": "dock_x1y2z3",
    "supplier_id": "sup_m1n2o3p4",
    "vehicle_type_id": "vt_tir",
    "date": "2026-03-25",
    "start_time": "09:00",
    "license_plate": "DW 12345",
    "driver_name": "Jan Kowalski",
    "cargo_description": "20 pallets of electronics"
  }'

import requests

API_KEY = "lk_live_abc123def456ghi789jkl012mno345"
BASE_URL = "https://avisator.locura.tech/api/v1"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

# Check available slots
slots = requests.get(
    f"{BASE_URL}/slots",
    headers=headers,
    params={"location_id": "loc_a1b2c3d4", "date": "2026-03-25"}
).json()

# Find first available slot
for dock in slots["data"]:
    for slot in dock["slots"]:
        if slot["available"]:
            print(f"Available: {dock['dock_name']} at {slot['start_time']}")
            break

# Create booking
booking = requests.post(
    f"{BASE_URL}/bookings",
    headers=headers,
    json={
        "location_id": "loc_a1b2c3d4",
        "dock_id": "dock_x1y2z3",
        "supplier_id": "sup_m1n2o3p4",
        "vehicle_type_id": "vt_tir",
        "date": "2026-03-25",
        "start_time": "09:00",
        "license_plate": "DW 12345",
        "driver_name": "Jan Kowalski",
        "cargo_description": "20 pallets of electronics"
    }
).json()

print(f"Booking created: {booking['data']['id']}")

const API_KEY = 'lk_live_abc123def456ghi789jkl012mno345';
const BASE_URL = 'https://avisator.locura.tech/api/v1';

const headers = {
  'Authorization': `Bearer ${API_KEY}`,
  'Content-Type': 'application/json'
};

async function createBooking() {
  // Check available slots
  const slotsRes = await fetch(
    `${BASE_URL}/slots?location_id=loc_a1b2c3d4&date=2026-03-25`,
    { headers }
  );
  const slots = await slotsRes.json();

  // Create the booking
  const bookingRes = await fetch(`${BASE_URL}/bookings`, {
    method: 'POST',
    headers,
    body: JSON.stringify({
      location_id: 'loc_a1b2c3d4',
      dock_id: 'dock_x1y2z3',
      supplier_id: 'sup_m1n2o3p4',
      vehicle_type_id: 'vt_tir',
      date: '2026-03-25',
      start_time: '09:00',
      license_plate: 'DW 12345',
      driver_name: 'Jan Kowalski',
      cargo_description: '20 pallets of electronics'
    })
  });

  const booking = await bookingRes.json();
  console.log(`Booking created: ${booking.data.id}`);
}

createBooking();

# Step 1: Push sales data
curl -X POST "https://pronostico.locura.tech/api/v1/data/sales" \
  -H "Authorization: Bearer lk_live_abc123def456" \
  -H "Content-Type: application/json" \
  -d '{
    "rows": [
      {"sku": "SKU-001", "date": "2026-01-15", "quantity": 120, "revenue": 4560.00},
      {"sku": "SKU-001", "date": "2026-02-15", "quantity": 135, "revenue": 5130.00},
      {"sku": "SKU-002", "date": "2026-01-15", "quantity": 45, "revenue": 1350.00}
    ]
  }'

# Step 2: Start analysis
curl -X POST "https://pronostico.locura.tech/api/v1/analysis/run" \
  -H "Authorization: Bearer lk_live_abc123def456" \
  -H "Content-Type: application/json" \
  -d '{"type": "full"}'

# Step 3: Check job status (poll until completed)
curl "https://pronostico.locura.tech/api/v1/analysis/job_q1r2s3t4" \
  -H "Authorization: Bearer lk_live_abc123def456"

# Step 4: Get results
curl "https://pronostico.locura.tech/api/v1/analysis/job_q1r2s3t4/results" \
  -H "Authorization: Bearer lk_live_abc123def456"

import requests
import time

API_KEY = "lk_live_abc123def456ghi789jkl012mno345"
BASE_URL = "https://pronostico.locura.tech/api/v1"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

# Step 1: Push sales data
upload = requests.post(
    f"{BASE_URL}/data/sales",
    headers=headers,
    json={
        "rows": [
            {"sku": "SKU-001", "date": "2026-01-15", "quantity": 120, "revenue": 4560.00},
            {"sku": "SKU-001", "date": "2026-02-15", "quantity": 135, "revenue": 5130.00},
            {"sku": "SKU-002", "date": "2026-01-15", "quantity": 45, "revenue": 1350.00}
        ]
    }
).json()
print(f"Upload: {upload['data']['upload_id']}")

# Step 2: Start analysis
analysis = requests.post(
    f"{BASE_URL}/analysis/run",
    headers=headers,
    json={"type": "full"}
).json()
job_id = analysis["data"]["job_id"]
print(f"Analysis started: {job_id}")

# Step 3: Poll for completion
while True:
    status = requests.get(
        f"{BASE_URL}/analysis/{job_id}",
        headers=headers
    ).json()

    if status["data"]["status"] == "completed":
        print("Analysis completed!")
        break
    elif status["data"]["status"] == "failed":
        print("Analysis failed!")
        break

    print(f"Progress: {status['data']['progress']}%")
    time.sleep(5)

# Step 4: Get results
results = requests.get(
    f"{BASE_URL}/analysis/{job_id}/results",
    headers=headers
).json()

summary = results["data"]["summary"]
print(f"Analyzed {summary['total_skus']} SKUs")
print(f"Recommendations: {summary['recommendations_count']}")

const API_KEY = 'lk_live_abc123def456ghi789jkl012mno345';
const BASE_URL = 'https://pronostico.locura.tech/api/v1';

const headers = {
  'Authorization': `Bearer ${API_KEY}`,
  'Content-Type': 'application/json'
};

function sleep(ms) {
  return new Promise(resolve => setTimeout(resolve, ms));
}

async function runAnalysis() {
  // Step 1: Push sales data
  const upload = await fetch(`${BASE_URL}/data/sales`, {
    method: 'POST',
    headers,
    body: JSON.stringify({
      rows: [
        { sku: 'SKU-001', date: '2026-01-15', quantity: 120, revenue: 4560.00 },
        { sku: 'SKU-001', date: '2026-02-15', quantity: 135, revenue: 5130.00 },
        { sku: 'SKU-002', date: '2026-01-15', quantity: 45, revenue: 1350.00 }
      ]
    })
  }).then(r => r.json());

  console.log(`Upload: ${upload.data.upload_id}`);

  // Step 2: Start analysis
  const analysis = await fetch(`${BASE_URL}/analysis/run`, {
    method: 'POST',
    headers,
    body: JSON.stringify({ type: 'full' })
  }).then(r => r.json());

  const jobId = analysis.data.job_id;
  console.log(`Analysis started: ${jobId}`);

  // Step 3: Poll for completion
  let status;
  do {
    await sleep(5000);
    status = await fetch(`${BASE_URL}/analysis/${jobId}`, { headers })
      .then(r => r.json());
    console.log(`Progress: ${status.data.progress}%`);
  } while (status.data.status !== 'completed' && status.data.status !== 'failed');

  // Step 4: Get results
  const results = await fetch(
    `${BASE_URL}/analysis/${jobId}/results`,
    { headers }
  ).then(r => r.json());

  const summary = results.data.summary;
  console.log(`Analyzed ${summary.total_skus} SKUs`);
  console.log(`Recommendations: ${summary.recommendations_count}`);
}

runAnalysis();

import requests
import time

API_KEY = "lk_live_abc123def456ghi789jkl012mno345"
BASE_URL = "https://docmaker.locura.tech/api/v1"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

# List active generation jobs
jobs = requests.get(
    f"{BASE_URL}/jobs",
    headers=headers,
    params={"status": "processing"}
).json()

for job in jobs["data"]:
    print(f"Job {job['id']}: {job['document_type']} - {job['progress']}%")

# Wait for a specific job to complete
job_id = "gjob_e5f6g7h8"
while True:
    job = requests.get(
        f"{BASE_URL}/jobs/{job_id}",
        headers=headers
    ).json()

    status = job["data"]["status"]
    progress = job["data"]["progress"]
    step = job["data"].get("current_step", "")

    print(f"[{progress}%] {step}")

    if status == "completed":
        doc_id = job["data"]["document_id"]
        print(f"Document ready: {doc_id}")

        # Download the document
        response = requests.get(
            f"{BASE_URL}/documents/{doc_id}/download",
            headers=headers
        )
        with open("document.pdf", "wb") as f:
            f.write(response.content)
        print("Downloaded: document.pdf")
        break
    elif status == "failed":
        print("Generation failed!")
        break

    time.sleep(3)