Spiritual Intelligence API

Dokumentation

Alles was du brauchst um loszulegen. API-Key erstellen, authentifizieren, ersten Request senden.

Quick Start

1

API-Key erstellen

Registriere dich auf der API-Seite fuer einen kostenlosen Key.

2

Authentifizierung

Sende deinen Key als Bearer Token im Authorization-Header:

Authorization: Bearer spk_live_dein_key_hier
3

Ersten Request senden

curl https://api.rene-koch.com/api/v1/collective-astrology/forecast/now \
  -H "Authorization: Bearer spk_live_dein_key"
4

Oder nutze das Python SDK

from spiritual_api import SpiritualAPI

api = SpiritualAPI("spk_live_dein_key")
forecast = api.collective.forecast_now()
print(forecast["sun"]["sign"])

Fehlerbehandlung

Alle Fehler folgen einem einheitlichen Format:

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit of 10 requests/minute exceeded",
    "request_id": "a1b2c3d4-...",
    "plan": "free"
  }
}
401

Ungueltiger oder fehlender API-Key

403

Endpoint erfordert hoeherenPlan

429

Rate Limit ueberschritten (Retry-After Header beachten)

422

Validierungsfehler in Request-Daten

Endpoint-Referenz

Vollstaendige interaktive Dokumentation mit Try-It-Out: OpenAPI/Swagger UI

Collective Astrology

Free

Kosmische Echtzeitdaten ohne Personenbezug

GET /api/v1/collective-astrology/forecast/now
POST /api/v1/collective-astrology/aspects
POST /api/v1/collective-astrology/moon-phase/current
GET /api/v1/collective-astrology/portal-days
GET /api/v1/collective-astrology/retrograde

Collective Extended

Free

Erweiterte kollektive Features

GET /api/v1/collective-extended/dreamspell
GET /api/v1/collective-extended/energy-quality
POST /api/v1/collective-extended/planetary-hours
GET /api/v1/collective-extended/tong-shu
GET /api/v1/collective-extended/sabbats

Astrology

Pro

Geburtshoroskop, Transite, Progressionen

POST /api/v1/astrology/calculate/{person_uuid}
GET /api/v1/astrology/summary/{person_uuid}
GET /api/v1/astrology/transits/{person_uuid}/now
GET /api/v1/astrology/transits/{person_uuid}/week

Human Design

Pro

Komplette HD Chart-Berechnung

POST /api/v1/hd/calculate/{person_uuid}
GET /api/v1/hd/{person_uuid}/complete
GET /api/v1/hd/{person_uuid}/gates
GET /api/v1/hd/{person_uuid}/channels

Numerology

Pro

Numerologische Berechnungen

POST /api/v1/numerology/calculate/{person_uuid}
POST /api/v1/numerology/name-analysis
POST /api/v1/numerology/timing/find-optimal-dates

Weitere Systeme

Pro

Gene Keys, BaZi, Enneagramm, Feng Shui und mehr

GET /api/v1/gene-keys/{person_uuid}
GET /api/v1/bazi/{person_uuid}
POST /api/v1/enneagram/calculate
POST /api/v1/feng-shui/kua-number
GET /api/v1/dreamspell/{person_uuid}
GET /api/v1/destiny-cards/{person_uuid}

Bereit loszulegen?

Erstelle deinen kostenlosen API-Key und starte in 2 Minuten.

Jetzt starten