Neue Affirmations API

Neue Affirmations API

Von Endlosschleifen zu sofortigem Wohlbefinden: Die Affirmations-API wurde neu aufgebaut, um personalisierte, tägliche Positivität ohne Reibung zu liefern. Jede Affirmation kommt jetzt mit einer stabilen ID, sauber bereinigten Daten und einem reichen Schema — zusammen mit Suche, Paginierung, Batch- und Tages-Endpunkten, einem vollständigen Wellness-Toolkit und Klartext-Antworten für SMS und Sprachassistenten.

🚀 Was ist neu

  • Stabile IDs – Jede Affirmation trägt eine konsistente hash-basierte id, damit Widgets, Benachrichtigungen und Caches synchron bleiben.
  • Saubere Daten, automatisch – Text- und Kategoriefelder werden von überflüssigem Leerraum befreit, bevor sie deine App erreichen.
  • Intelligente Kategorien – Die 19 Kategorien werden direkt aus dem Datensatz abgeleitet und sortiert, ohne hartcodierte Abweichungen.
  • Hilfreiche Fehler – Unbekannte Kategorien liefern ein klares 404, statt hängen zu bleiben oder in Schleifen zu geraten.
  • Reicheres Schema – Jede Affirmation liefert id, text, category, mood, lang und length.
  • Finde, was du brauchst – Suche und Paginierung beim Listen-Endpunkt sowie ein konfigurierbarer Batch-Endpunkt.
  • Deterministische Tagesauswahl – /today liefert für jeden Nutzer dieselbe Affirmation des Tages.
  • Wellness-Toolkit – Personalisiere mit Namen, formuliere negative Gedanken um und kombiniere Affirmationen mit Atemübungen.

🛠 API-Endpunkte

1. Affirmationen auflisten

GET /v1/affirmations

Parameter:

  • category (optional): Filtert die Liste nach Kategorie, zum Beispiel confidence oder self-love.
  • search (optional): Volltextsuche über den Affirmationstext.
  • page (default: 1): Seitennummer für die Paginierung.
  • limit (default: 10): Ergebnisse pro Seite, maximal 50.
  • lang (default: en): Sprachcode. In dieser Version werden englische Inhalte zurückgegeben.

2. Zufällige Affirmation

GET /v1/affirmations/random

Parameter:

  • category (optional): Gibt eine zufällige Affirmation aus einer bestimmten Kategorie zurück.
  • lang (default: en): Sprachcode. In dieser Version werden englische Inhalte zurückgegeben.
  • format (default: json): Verwende json für das vollständige Objekt oder text für eine reine Textantwort.

3. Zufällige Affirmation nach Kategorie

GET /v1/affirmations/categories/{category}/random

Parameter:

  • category (required): Die Kategorie, aus der ausgewählt wird, zum Beispiel sleep. Unbekannte Kategorien liefern ein klares 404.

4. Kategorien auflisten

GET /v1/affirmations/categories

Gibt die vollständige, sortierte Liste der Kategorien zurück — von anxiety-relief und calm bis confidence, focus, gratitude, parenting, resilience, self-love, sleep, success und mehr.

5. Batch-Affirmationen

GET /v1/affirmations/batch

Parameter:

  • category (optional): Filtert den Batch nach Kategorie.
  • limit (default: 10): Anzahl der zurückzugebenden Affirmationen, maximal 50.
  • lang (default: en): Sprachcode. In dieser Version werden englische Inhalte zurückgegeben.

6. Affirmation des Tages

GET /v1/affirmations/today

Parameter:

  • category (optional): Gibt die deterministische Tagesauswahl innerhalb einer Kategorie zurück.
  • lang (default: en): Sprachcode. In dieser Version werden englische Inhalte zurückgegeben.

Der Alias /daily gibt dieselbe Affirmation des Tages zurück.

7. Personalisieren

POST /v1/affirmations/personalize

Body:

  • mood (optional): Stimmung oder Kategorie, aus der geschöpft wird, zum Beispiel confidence. Standard ist happiness.
  • goal (optional): Die Absicht hinter der Affirmation.
  • name (optional): Ein Name, der in die Affirmation eingewoben wird, zum Beispiel “I am confident, Ava.”

8. Einen negativen Gedanken umformulieren

POST /v1/affirmations/reframe

Body:

  • negativeThought (required): Der Gedanke, der umformuliert werden soll, zum Beispiel “I always fail”.

Gibt eine umformulierte Aussage zusammen mit einer passenden Resilience-Affirmation zurück.

9. Affirmation + Atem-Bundle

GET /v1/affirmations/bundle

Parameter:

  • category (optional): Die Kategorie, aus der geschöpft wird. Die Kategorie sleep liefert die 4-7-8-Atemübung; alle anderen Kategorien liefern box breathing.

10. Vorgeschlagener Zeitplan

GET /v1/affirmations/schedule

Parameter:

  • timezone (optional): Zeitzonen-Bezeichnung für die vorgeschlagenen Zeitfenster, zum Beispiel Europe/Berlin. Standard ist UTC.

📦 Antwortbeispiele

Zufällige Affirmation:

{
  "id": 1874329517,
  "text": "I am confident, capable, and ready for today.",
  "category": "confidence",
  "mood": "confidence",
  "lang": "en",
  "length": 42
}

Personalisierte Affirmation:

{
  "id": 55123874,
  "text": "I am confident, Ava.",
  "category": "confidence",
  "mood": "confidence",
  "lang": "en",
  "length": 20
}

Umformulierter Gedanke:

{
  "reframe": "Even though \"I always fail\", I choose to believe: I am learning and growing every day.",
  "affirmation": {
    "id": 912345678,
    "text": "I am learning and growing every day.",
    "category": "resilience",
    "mood": "resilience",
    "lang": "en",
    "length": 36
  }
}

Wellness-Bundle:

{
  "affirmation": {
    "id": 44556677,
    "text": "I release the day and welcome rest.",
    "category": "sleep",
    "mood": "sleep",
    "lang": "en",
    "length": 36
  },
  "breathing": {
    "name": "4-7-8",
    "steps": ["Inhale 4s", "Hold 7s", "Exhale 8s"]
  }
}

Vorgeschlagener Zeitplan:

{
  "morning": "08:00 Europe/Berlin",
  "evening": "21:00 Europe/Berlin",
  "timezone": "Europe/Berlin"
}

✨ Antworten in mehreren Formaten

Der Zufalls-Endpunkt spricht sowohl JSON als auch reinen Text. Verwende ?format=json (den Standard) für das vollständige strukturierte Objekt in Web- und Mobile-Apps oder ?format=text für einen direkt versandfertigen String in SMS-Flows, Sprachassistenten und Widgets.

🎯 Gemacht für

  • Entwickler, die Wellness-Apps, Chatbots und Motivationsfunktionen entwickeln und eine stabile, gut dokumentierte API wollen.
  • Produktmanager, die Engagement mit täglichen Benachrichtigungen, Streaks und deterministischen täglichen Inhalten steigern.
  • Ersteller von Wellness-Apps, die zuverlässige, kategorisierte Affirmationsinhalte in großem Umfang benötigen.
  • Enterprise-Teams, die skalierbare Endpunkte im SDK-Stil mit Postman-fähigem Onboarding erwarten.

🌟 Warum die Affirmations-API wählen?

  • Zuverlässig by design: Stabile IDs, bereinigte Daten und klare 404s bedeuten weniger Überraschungen in der Produktion.
  • Tiefe, wenn du sie brauchst: 19 Kategorien, die von Angstlösung bis Selbstliebe reichen.
  • Mehr als ein einziger Aufruf: Personalisierung, Umformulierung, Atem-Bundles und Zeitplanung in einer einzigen API.
  • Entwicklerfreundlich: Suche, Paginierung, Batching, Antworten in mehreren Formaten und sofort einsatzbereite Snippets.
  • Wellness-ready: 99.99% Uptime mit latenzarmen Antworten für alltägliche positive Momente.

🚀 Erste Schritte

  • Postman-Collection: Importiere docs/affirmations-postman.json, um jeden Endpunkt mit einem Klick zu erkunden.
  • Code-Snippets: Kopiere sofort lauffähige Beispiele für cURL, JavaScript und Python aus docs/affirmations-snippets.md.
  • LLM-ready: docs/llms.txt gibt KI-Agenten eine strukturierte Zusammenfassung der API.

Beginne noch heute, positive Momente zu schaffen — rufe den Today-Endpunkt für eine deterministische tägliche Affirmation auf und ergänze dann Personalisierung und Atem-Bundles, um das Wellness-Erlebnis zu vervollständigen.