Kategorie-IDs abrufen

Überblick

Bevor Sie Artikel über die API erstellen können, benötigen Sie die IDs der Kategorien, denen Sie Ihre Artikel zuordnen möchten. Jeder Artikel muss mindestens einer und maximal drei Kategorien zugeordnet werden.

API-Endpunkt

GET /api/categories

Authentifizierung: Bearer Token erforderlich

Response Felder

Anfrage stellen

cURL Beispiel

curl -X GET https://ihre-domain.de/api/categories \
  -H "Authorization: Bearer IHR_API_TOKEN" \
  -H "Accept: application/json"

JavaScript (fetch)

fetch('https://ihre-domain.de/api/categories', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer IHR_API_TOKEN',
    'Accept': 'application/json'
  }
})
.then(response => response.json())
.then(data => {
  console.log('Verfügbare Kategorien:', data.data);
});

PHP

$ch = curl_init('https://ihre-domain.de/api/categories');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer IHR_API_TOKEN',
    'Accept: application/json'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$categories = json_decode($response, true);
print_r($categories['data']);

Antwort-Format

Die API gibt eine Liste aller verfügbaren Kategorien zurück:

{
  "data": [
    {
      "id": 1,
      "name": "Immobilienmarkt",
      "description": "Aktuelle Entwicklungen und Trends im Immobilienmarkt"
    },
    {
      "id": 2,
      "name": "Finanzierung",
      "description": "Themen rund um Immobilienfinanzierung und Kredite"
    },
    {
      "id": 3,
      "name": "Recht & Steuern",
      "description": "Rechtliche und steuerliche Aspekte"
    }
  ]
}

Kategorien verwenden

IDs extrahieren

Speichern Sie die relevanten Kategorie-IDs für spätere Verwendung:

const categories = data.data;
const finanzierungId = categories.find(c => c.name === 'Finanzierung')?.id;
const rechtId = categories.find(c => c.name === 'Recht & Steuern')?.id;

// Für Artikel-Erstellung
const categoryIds = [finanzierungId, rechtId];

Kategorien in Artikel-Erstellung

Beim Erstellen eines Artikels übergeben Sie ein Array mit 1-3 Kategorie-IDs:

{
  "title": "Mein Artikel",
  "content": "...",
  "categories": [1, 2]
}

Wichtige Hinweise

Validierung

• Minimum: 1 Kategorie muss ausgewählt werden
• Maximum: 3 Kategorien können zugeordnet werden
• Alle IDs müssen existieren, sonst wird ein Validierungsfehler zurückgegeben

Fehlerbehandlung

401 Unauthorized:

{
  "message": "Unauthenticated."
}

→ Token fehlt oder ist ungültig

Erfolgreiche Antwort (200 OK):

{
  "data": [...]
}

Caching-Strategie

Kategorien ändern sich selten. Empfohlene Caching-Strategien:

Local Storage (Browser)

// Kategorien abrufen und cachen
async function getCategories() {
  const cached = localStorage.getItem('categories');
  const cacheTime = localStorage.getItem('categories_time');

  // Cache 24 Stunden gültig
  if (cached && cacheTime && Date.now() - cacheTime < 86400000) {
    return JSON.parse(cached);
  }

  const response = await fetch('/api/categories', {
    headers: {
      'Authorization': 'Bearer ' + apiToken,
      'Accept': 'application/json'
    }
  });

  const data = await response.json();
  localStorage.setItem('categories', JSON.stringify(data.data));
  localStorage.setItem('categories_time', Date.now());

  return data.data;
}

File Cache (PHP)

function getCategories($apiToken) {
    $cacheFile = 'cache/categories.json';
    $cacheTime = 86400; // 24 Stunden

    if (file_exists($cacheFile) && time() - filemtime($cacheFile) < $cacheTime) {
        return json_decode(file_get_contents($cacheFile), true);
    }

    $ch = curl_init('https://ihre-domain.de/api/categories');
    curl_setopt($ch, CURLOPT_HTTPHEADER, [
        'Authorization: Bearer ' . $apiToken,
        'Accept: application/json'
    ]);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    $response = curl_exec($ch);
    curl_close($ch);

    file_put_contents($cacheFile, $response);

    return json_decode($response, true)['data'];
}

Nächste Schritte

Mit den Kategorie-IDs können Sie nun:

• Artikel erstellen und Kategorien zuordnen
• Artikel für Unternehmen veröffentlichen
• Ihre Anwendung mit dynamischer Kategorieauswahl erweitern