Oracle API-Dokumentation

Alles, was Sie brauchen, um spirituelle Erkenntnisse und personalisierte Orakellesungen in Ihre eigenen Apps zu integrieren.

Documentation

Erste Schritte Authentifizierung Lesungen Geschenke Fehlercodes

Erste Schritte

Verbinden Sie Ihre Anwendungen mit Yes No Oracle über eine einfache REST-API. Rufen Sie Ihre Lesungen ab, verwalten Sie Ihren Verlauf und verschenken Sie Lesungen – alles mit wenigen JSON-Anfragen. Diese Dokumentation behandelt Authentifizierung, verfügbare Endpunkte und Fehlercodes.

Alle Antworten sind JSON. Authentifizierte Endpunkte erfordern Ihren persönlichen API-Schlüssel als Bearer-Token.

Authentifizierung

Alle authentifizierten Endpunkte erfordern einen Authorization-Header mit Ihrem API-Schlüssel, den Sie in Ihren Kontoeinstellungen generieren können.

Basis-URL

TEXT

https://www.yes-no-oracle.com/api/v1

BASH

curl -X GET "https://www.yes-no-oracle.com/api/v1/readings" \
  -H "Authorization: Bearer yno_your_api_key"

Halten Sie Ihren Schlüssel privat

Exponieren Sie Ihren API-Schlüssel niemals in clientseitigem Code (Browser, mobile App). Führen Sie API-Aufrufe immer von einem sicheren Server aus.

Lesungen

Abrufen, aktualisieren oder löschen Sie Lesungen, die in Ihrem Konto gespeichert sind. Alle Endpunkte erfordern Authentifizierung.

Lesungen auflisten

Gibt Ihre Lesungen in umgekehrter chronologischer Reihenfolge zurück, mit cursorbasierter Paginierung.

GEThttps://www.yes-no-oracle.com/api/v1/readings

Parameter	Type	Description
`limit`	number	Anzahl der Ergebnisse pro Seite (Standard: 50, max: 100).
`cursor`	string	Paginierungscursor – verwenden Sie den nextCursor-Wert aus der vorherigen Antwort.

BASH

curl "https://www.yes-no-oracle.com/api/v1/readings?limit=10" \
  -H "Authorization: Bearer yno_your_api_key"

JSON

{
  "data": [
    {
      "id": "clx...",
      "readingTypeId": "destiny",
      "cards": [...],
      "note": "This spoke to me deeply.",
      "mood": "inspired",
      "customTitle": null,
      "cardCount": 3,
      "createdAt": "2026-04-28T14:23:00.000Z"
    }
  ],
  "nextCursor": "clx..."
}

Eine Lesung abrufen

Eine einzelne Lesung anhand ihrer ID abrufen.

GEThttps://www.yes-no-oracle.com/api/v1/readings/:id

BASH

curl "https://www.yes-no-oracle.com/api/v1/readings/clx..." \
  -H "Authorization: Bearer yno_your_api_key"

JSON

{
  "data": {
    "id": "clx...",
    "readingTypeId": "love",
    "cards": [...],
    "note": null,
    "mood": "hopeful",
    "createdAt": "2026-04-28T14:23:00.000Z"
  }
}

Eine Lesung aktualisieren

Aktualisieren Sie die Notiz und/oder Stimmung einer bestehenden Lesung.

PATCHhttps://www.yes-no-oracle.com/api/v1/readings/:id

Parameter	Type	Description
`note`	string	Optional. Persönliche Notiz zur Lesung.
`mood`	string	Optional. Stimmungs-Tag für die Lesung.

BASH

curl -X PATCH "https://www.yes-no-oracle.com/api/v1/readings/clx..." \
  -H "Authorization: Bearer yno_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "note": "Updated thoughts." }'

Eine Lesung löschen

Eine Lesung dauerhaft aus Ihrem Konto löschen.

DELETEhttps://www.yes-no-oracle.com/api/v1/readings/:id

BASH

curl -X DELETE "https://www.yes-no-oracle.com/api/v1/readings/clx..." \
  -H "Authorization: Bearer yno_your_api_key"

JSON

{ "data": { "success": true } }

Geschenke

Exklusiver Zugang

Senden Sie Orakellesungen als Geschenke. Jedes Geschenk generiert einen einzigartigen Link, der unbegrenzt gültig ist. Begrenzt auf 3 Geschenke pro 24 Stunden.

Aktuelle Geschenke auflisten

Gibt Geschenke zurück, die in den letzten 24 Stunden erstellt wurden.

GEThttps://www.yes-no-oracle.com/api/v1/gifts

BASH

curl "https://www.yes-no-oracle.com/api/v1/gifts" \
  -H "Authorization: Bearer yno_your_api_key"

JSON

{
  "data": [
    {
      "id": "clx...",
      "readingTypeId": "love",
      "token": "a3f9b...",
      "sentAt": "2026-05-01T08:00:00.000Z",
      "isUsed": false,
      "recipientEmail": null,
      "url": "https://www.yes-no-oracle.com/gift/a3f9b..."
    }
  ]
}

Ein Geschenk erstellen

Generieren Sie einen neuen Geschenk-Token für einen bestimmten Lesungstyp.

readingTypeId	Lesung
`destiny`	Destiny Reading
`love`	Love Reading
`guardian-angel`	Guardian Angel Reading
`life-purpose`	Life Purpose Reading
`relationship`	Relationship Reading
`fortune`	Fortune Reading
`guidance`	Guidance Reading
`health`	Health Reading

POSThttps://www.yes-no-oracle.com/api/v1/gifts

Parameter	Type	Description
`readingTypeId`required	string	Erforderlich. Der zu schenkende Lesungstyp (siehe Tabelle oben).
`message`	string	Optional. Persönliche Nachricht, die dem Geschenk beigefügt ist.

BASH

curl -X POST "https://www.yes-no-oracle.com/api/v1/gifts" \
  -H "Authorization: Bearer yno_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "readingTypeId": "love",
    "message": "Thinking of you — here is a little something."
  }'

JSON

{
  "data": {
    "id": "clx...",
    "token": "a3f9b...",
    "readingTypeId": "love",
    "sentAt": "2026-05-01T09:00:00.000Z",
    "url": "https://www.yes-no-oracle.com/gift/a3f9b..."
  }
}

Fehlercodes

Die Oracle-API verwendet Standard-HTTP-Statuscodes. Fehlerantworten enthalten immer ein error-Feld mit einer menschenlesbaren Nachricht.

Code	Meaning
200	Anfrage erfolgreich.
201	Ressource erfolgreich erstellt.
400	Ungültige Anfrage – fehlende oder ungültige Parameter.
401	Nicht autorisiert – fehlender oder ungültiger API-Schlüssel.
403	Verboten – VIP-Abonnement erforderlich.
404	Ressource nicht gefunden.
429	Ratenlimit überschritten.
500	Interner Serverfehler.

JSON

{
  "error": "VIP subscription required"
}