Entwickler-Doku: Nexvyra API

1) Alle Themen abrufen

Endpoint: GET /api/topics.json

curl -s https://nexvyra.de/api/topics.json | jq '.topics[] | {slug, title}'

<?php
$ch = curl_init('https://nexvyra.de/api/topics.json');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_USERAGENT, 'MyApp/1.0 (+https://example.com)');
$json = curl_exec($ch);
curl_close($ch);
$data = json_decode($json, true);

foreach ($data['topics'] as $t) {
    echo $t['slug'], ' — ', $t['title'], PHP_EOL;
}

const res = await fetch('https://nexvyra.de/api/topics.json');
const data = await res.json();
for (const t of data.topics) {
  console.log(t.slug, '—', t.title);
}

import requests

data = requests.get('https://nexvyra.de/api/topics.json', timeout=10).json()
for t in data['topics']:
    print(t['slug'], '—', t['title'])

2) Einzelfakten für RAG abrufen

Endpoint: GET /api/facts.json — jede Aussage mit Wert, Quelle, Autoritätsstufe (A/B/C/D) und letztem Prüfdatum.

# Alle Fakten zu Wärmepumpen-Förderung
curl -s https://nexvyra.de/api/facts.json \
  | jq '.facts[] | select(.slug | test("waermepumpe"))'

import requests

facts = requests.get('https://nexvyra.de/api/facts.json', timeout=10).json()['facts']
# Finde alle Fakten mit Autoritätsstufe A (amtliche Primärquelle)
amtlich = [f for f in facts if f['source_authority'] == 'A']
print(f"{len(amtlich)} amtliche Einzelfakten verfügbar.")

const facts = (await (await fetch('https://nexvyra.de/api/facts.json')).json()).facts;
const grundfreibetrag = facts.filter(f => f.slug === 'grundfreibetrag-2026');
console.log(grundfreibetrag);

3) Ein einzelnes Thema laden

Endpoint: GET /fakten/{slug}.json oder /fakten/{slug}.md

curl -s https://nexvyra.de/fakten/geg-47-nachruestpflicht.json | jq

<?php
function nexvyra_topic(string $slug): array {
    $url = "https://nexvyra.de/fakten/" . rawurlencode($slug) . ".json";
    $body = file_get_contents($url, false, stream_context_create([
        'http' => ['header' => "User-Agent: MyApp/1.0\r\n", 'timeout' => 10]
    ]));
    return json_decode($body, true);
}

$topic = nexvyra_topic('beg-em-waermepumpe');
echo $topic['title'], PHP_EOL;
foreach ($topic['facts'] as $f) {
    echo " - {$f['label']}: {$f['value']}  ({$f['source_authority']})\n";
}

import requests

def nexvyra_topic(slug: str) -> dict:
    r = requests.get(f"https://nexvyra.de/fakten/{slug}.json", timeout=10)
    r.raise_for_status()
    return r.json()

t = nexvyra_topic('grundfreibetrag-2026')
print(t['title'])
for fact in t.get('facts', []):
    print(f"  {fact['label']}: {fact['value']}  (Quelle: {fact['source_url']})")