API Calls & Voorbeelden

https://api.routix.nl/functions/v1/api/{versie}/{publiekVestigingId}/{resource}

GET https://api.routix.nl/functions/v1/api/v1/RS2RDH3B/accounts

Authorization: Bearer eyJhbGciOiJIUzI1NiIs...

GET /functions/v1/api/v1/{vestigingId}/accounts

curl -X GET "https://api.routix.nl/functions/v1/api/v1/RS2RDH3B/accounts?limit=10&offset=0" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "company_name": "Acme Transport B.V.",
      "email": "info@acmetransport.nl",
      "phone": "+31 20 123 4567",
      "account_type": "customer",
      "status": "active"
    },
    {
      "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
      "company_name": "FastFreight Logistics",
      "email": "contact@fastfreight.nl",
      "phone": "+31 30 987 6543",
      "account_type": "carrier",
      "status": "active"
    }
  ],
  "pagination": {
    "limit": 10,
    "offset": 0,
    "total": 2
  },
  "version": "v1"
}

{
  "data": [ ... ],
  "pagination": {
    "limit": 50,
    "offset": 0,
    "total": 123
  },
  "version": "v1"
}

{
  "error": "insufficient_scope",
  "error_description": "Token does not contain the required scope: routix:accounts:read"
}

const ROUTIX_URL = 'https://api.routix.nl';
 
// Stap 1: Token ophalen (Client Credentials)
async function getToken(clientId, clientSecret) {
  const res = await fetch(`${ROUTIX_URL}/functions/v1/oauth-token`, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      grant_type: 'client_credentials',
      client_id: clientId,
      client_secret: clientSecret,
    }),
  });
 
  if (!res.ok) {
    const err = await res.json();
    throw new Error(`Auth mislukt: ${err.error_description}`);
  }
 
  const data = await res.json();
  return data.access_token;
}
 
// Stap 2: Accounts ophalen
async function getAccounts(token, branchId, { limit = 50, offset = 0 } = {}) {
  const url = `${ROUTIX_URL}/functions/v1/api/v1/${branchId}/accounts?limit=${limit}&offset=${offset}`;
  const res = await fetch(url, {
    headers: { Authorization: `Bearer ${token}` },
  });
 
  if (!res.ok) {
    const err = await res.json();
    throw new Error(`API fout: ${err.error_description}`);
  }
 
  return res.json();
}
 
// Gebruik
const token = await getToken('your-client-id', 'routix_a1b2c3d4...');
const result = await getAccounts(token, 'RS2RDH3B', { limit: 10 });
 
console.log(`${result.pagination.total} accounts gevonden`);
result.data.forEach(a => console.log(`${a.company_name} (${a.account_type})`));

import requests
 
ROUTIX_URL = "https://api.routix.nl"
 
def get_token(client_id: str, client_secret: str) -> str:
    """Haal een OAuth access token op via Client Credentials."""
    response = requests.post(
        f"{ROUTIX_URL}/functions/v1/oauth-token",
        json={
            "grant_type": "client_credentials",
            "client_id": client_id,
            "client_secret": client_secret,
        },
    )
    response.raise_for_status()
    return response.json()["access_token"]
 
def get_accounts(token: str, branch_id: str, limit: int = 50, offset: int = 0) -> dict:
    """Haal accounts op van een specifieke vestiging."""
    response = requests.get(
        f"{ROUTIX_URL}/functions/v1/api/v1/{branch_id}/accounts",
        headers={"Authorization": f"Bearer {token}"},
        params={"limit": limit, "offset": offset},
    )
    response.raise_for_status()
    return response.json()
 
# Gebruik
token = get_token("your-client-id", "routix_a1b2c3d4...")
result = get_accounts(token, "RS2RDH3B", limit=10)
 
print(f"{result['pagination']['total']} accounts gevonden")
for account in result["data"]:
    print(f"  {account['company_name']} ({account['account_type']})")

<?php
 
$routixUrl = 'https://api.routix.nl';
 
// Stap 1: Token ophalen
function getToken(string $clientId, string $clientSecret): string {
    global $routixUrl;
 
    $ch = curl_init("$routixUrl/functions/v1/oauth-token");
    curl_setopt_array($ch, [
        CURLOPT_POST => true,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
        CURLOPT_POSTFIELDS => json_encode([
            'grant_type' => 'client_credentials',
            'client_id' => $clientId,
            'client_secret' => $clientSecret,
        ]),
    ]);
 
    $response = json_decode(curl_exec($ch), true);
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);
 
    if ($httpCode !== 200) {
        throw new Exception("Auth mislukt: " . ($response['error_description'] ?? 'Onbekende fout'));
    }
 
    return $response['access_token'];
}
 
// Stap 2: Accounts ophalen
function getAccounts(string $token, string $branchId, int $limit = 50, int $offset = 0): array {
    global $routixUrl;
 
    $url = "$routixUrl/functions/v1/api/v1/$branchId/accounts?" . http_build_query([
        'limit' => $limit,
        'offset' => $offset,
    ]);
 
    $ch = curl_init($url);
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER => ["Authorization: Bearer $token"],
    ]);
 
    $response = json_decode(curl_exec($ch), true);
    curl_close($ch);
 
    return $response;
}
 
// Gebruik
$token = getToken('your-client-id', 'routix_a1b2c3d4...');
$result = getAccounts($token, 'RS2RDH3B', 10);
 
echo "{$result['pagination']['total']} accounts gevonden\n";
foreach ($result['data'] as $account) {
    echo "  {$account['company_name']} ({$account['account_type']})\n";
}

using System.Net.Http.Json;
 
var routixUrl = "https://api.routix.nl";
var httpClient = new HttpClient();
 
// Token ophalen
var tokenResponse = await httpClient.PostAsJsonAsync(
    $"{routixUrl}/functions/v1/oauth-token",
    new {
        grant_type = "client_credentials",
        client_id = "your-client-id",
        client_secret = "routix_a1b2c3d4..."
    });
 
var tokenData = await tokenResponse.Content.ReadFromJsonAsync<Dictionary<string, object>>();
var token = tokenData["access_token"].ToString();
 
// Accounts ophalen
httpClient.DefaultRequestHeaders.Authorization =
    new System.Net.Http.Headers.AuthenticationHeaderValue("Bearer", token);
 
var accounts = await httpClient.GetFromJsonAsync<JsonElement>(
    $"{routixUrl}/functions/v1/api/v1/RS2RDH3B/accounts?limit=10");
 
Console.WriteLine($"{accounts.GetProperty("pagination").GetProperty("total")} accounts gevonden");