API Dokumentācija

Integrējiet erekini.eu jūsu sistēmās. Automatizējiet rēķinu izrakstīšanu un klientu pārvaldību ar mūsu REST API.

🚀Ātrais sākums

1. Iegūstiet API atslēgu

Dodieties uz Organizācijas iestatījumi → API un ģenerējiet jaunu API atslēgu.

2. Autentifikācija

Visiem pieprasījumiem jāsatur Authorization header ar Bearer token:

curl
curl -X GET "https://www.erekini.eu/api/v1/invoices" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
Read Operations
60 pieprasījumi/min
Write Operations
30 pieprasījumi/min

Health Check

Kļūdu kodi

400
Bad Request
Nepareizi pieprasījuma parametri
401
Unauthorized
Nederīga vai trūkstoša API atslēga
403
Forbidden
Nav atļaujas veikt šo darbību
404
Not Found
Resurss neeksistē
429
Too Many Requests
Pārsniegts pieprasījumu limits
500
Internal Server Error
Servera kļūda, mēģiniet vēlreiz

Koda piemēri

JavaScript / Node.js

fetch-invoices.js
const API_KEY = 'your-api-key';
const BASE_URL = 'https://www.erekini.eu/api/v1';

async function getInvoices() {
  const response = await fetch(`${BASE_URL}/invoices?status=issued`, {
    headers: {
      'Authorization': `Bearer ${API_KEY}`,
      'Content-Type': 'application/json'
    }
  });
  
  if (!response.ok) {
    throw new Error(`HTTP error! status: ${response.status}`);
  }
  
  return response.json();
}

async function createInvoice(clientId, items) {
  const response = await fetch(`${BASE_URL}/invoices`, {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${API_KEY}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      client_id: clientId,
      due_date: '2026-02-10',
      items: items
    })
  });
  
  return response.json();
}

🐍 Python

invoices.py
import requests

API_KEY = 'your-api-key'
BASE_URL = 'https://www.erekini.eu/api/v1'

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

# Get all invoices
def get_invoices(status=None):
    params = {'status': status} if status else {}
    response = requests.get(f'{BASE_URL}/invoices', headers=headers, params=params)
    response.raise_for_status()
    return response.json()

# Create invoice
def create_invoice(client_id, items, due_date):
    data = {
        'client_id': client_id,
        'due_date': due_date,
        'items': items
    }
    response = requests.post(f'{BASE_URL}/invoices', headers=headers, json=data)
    response.raise_for_status()
    return response.json()

Nepieciešama palīdzība?

Ja rodas jautājumi par API integrāciju, sazinieties ar mums.

info@erekini.eu