नया Affirmations API

अनंत लूप से तुरंत वेलनेस तक: Affirmations API को इस तरह फिर से बनाया गया है कि यह बिना किसी रुकावट के व्यक्तिगत, रोज़ाना की सकारात्मकता दे। अब हर अफर्मेशन एक स्टेबल ID, साफ़-सुथरे ट्रिम किए गए डेटा और एक समृद्ध स्कीमा के साथ आता है — साथ ही सर्च, पेजिनेशन, बैच और डेली एंडपॉइंट, एक पूरा वेलनेस टूलकिट, और SMS तथा वॉइस असिस्टेंट के लिए प्लेन-टेक्स्ट रिस्पॉन्स।

🚀 नया क्या है

• स्टेबल ID – हर अफर्मेशन के साथ एक सुसंगत हैश-आधारित id आता है, ताकि विजेट, नोटिफ़िकेशन और कैश हमेशा सिंक में रहें।
• साफ़ डेटा, अपने आप – टेक्स्ट और category फ़ील्ड से आपके ऐप तक पहुँचने से पहले ही अतिरिक्त स्पेस हटा दिए जाते हैं।
• स्मार्ट श्रेणियाँ – 19 श्रेणियाँ सीधे डेटासेट से निकाली और क्रमबद्ध की जाती हैं, कोई हार्डकोडेड बदलाव नहीं।
• मददगार एरर – अज्ञात श्रेणियाँ हैंग या लूप होने के बजाय स्पष्ट 404 लौटाती हैं।
• समृद्ध स्कीमा – हर अफर्मेशन id, text, category, mood, lang, और length लौटाता है।
• जो चाहिए वो पाएँ – लिस्ट एंडपॉइंट पर सर्च और पेजिनेशन, साथ ही एक कॉन्फ़िगर करने योग्य बैच एंडपॉइंट।
• तयशुदा डेली पिक – /today हर यूज़र के लिए दिन का वही अफर्मेशन लौटाता है।
• वेलनेस टूलकिट – नाम के अनुसार पर्सनलाइज़ करें, नकारात्मक विचारों को रीफ़्रेम करें, और अफर्मेशन को ब्रीदिंग एक्सरसाइज़ के साथ जोड़ें।

🛠 API एंडपॉइंट

1. अफर्मेशन लिस्ट करें

GET /v1/affirmations

पैरामीटर:

• category (वैकल्पिक): लिस्ट को श्रेणी के अनुसार फ़िल्टर करें, जैसे confidence या self-love।
• search (वैकल्पिक): अफर्मेशन टेक्स्ट में फ़ुल-टेक्स्ट सर्च।
• page (डिफ़ॉल्ट: 1): पेजिनेशन के लिए पेज नंबर।
• limit (डिफ़ॉल्ट: 10): प्रति पेज परिणाम, अधिकतम 50 तक।
• lang (डिफ़ॉल्ट: en): भाषा कोड। इस रिलीज़ में अंग्रेज़ी सामग्री लौटाई जाती है।

2. रैंडम अफर्मेशन

GET /v1/affirmations/random

पैरामीटर:

• category (वैकल्पिक): किसी विशिष्ट श्रेणी से एक रैंडम अफर्मेशन लौटाएँ।
• lang (डिफ़ॉल्ट: en): भाषा कोड। इस रिलीज़ में अंग्रेज़ी सामग्री लौटाई जाती है।
• format (डिफ़ॉल्ट: json): पूरे ऑब्जेक्ट के लिए json या प्लेन-टेक्स्ट रिस्पॉन्स के लिए text इस्तेमाल करें।

3. श्रेणी के अनुसार रैंडम अफर्मेशन

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

पैरामीटर:

• category (आवश्यक): चुनने के लिए श्रेणी, जैसे sleep। अज्ञात श्रेणियाँ स्पष्ट 404 लौटाती हैं।

4. श्रेणियाँ लिस्ट करें

GET /v1/affirmations/categories

श्रेणियों की पूरी, क्रमबद्ध सूची लौटाता है — anxiety-relief और calm से लेकर confidence, focus, gratitude, parenting, resilience, self-love, sleep, success और अन्य तक।

5. बैच अफर्मेशन

GET /v1/affirmations/batch

पैरामीटर:

• category (वैकल्पिक): बैच को श्रेणी के अनुसार फ़िल्टर करें।
• limit (डिफ़ॉल्ट: 10): लौटाए जाने वाले अफर्मेशन की संख्या, अधिकतम 50 तक।
• lang (डिफ़ॉल्ट: en): भाषा कोड। इस रिलीज़ में अंग्रेज़ी सामग्री लौटाई जाती है।

6. आज का अफर्मेशन

GET /v1/affirmations/today

पैरामीटर:

• category (वैकल्पिक): किसी श्रेणी के भीतर तयशुदा डेली पिक लौटाएँ।
• lang (डिफ़ॉल्ट: en): भाषा कोड। इस रिलीज़ में अंग्रेज़ी सामग्री लौटाई जाती है।

/daily उपनाम दिन का वही अफर्मेशन लौटाता है।

7. पर्सनलाइज़ करें

POST /v1/affirmations/personalize

बॉडी:

• mood (वैकल्पिक): जिस मूड या श्रेणी से चुनना है, जैसे confidence। डिफ़ॉल्ट happiness है।
• goal (वैकल्पिक): अफर्मेशन के पीछे का इरादा।
• name (वैकल्पिक): अफर्मेशन में जोड़ने के लिए एक नाम, उदाहरण के लिए “I am confident, Ava.”

8. नकारात्मक विचार को रीफ़्रेम करें

POST /v1/affirmations/reframe

बॉडी:

• negativeThought (आवश्यक): जिस विचार को रीफ़्रेम करना है, उदाहरण के लिए “I always fail”।

रीफ़्रेम किया गया वाक्य और उसके साथ मेल खाता resilience अफर्मेशन लौटाता है।

9. अफर्मेशन + ब्रीदिंग बंडल

GET /v1/affirmations/bundle

पैरामीटर:

• category (वैकल्पिक): जिस श्रेणी से चुनना है। sleep श्रेणी 4-7-8 ब्रीदिंग एक्सरसाइज़ लौटाती है; बाकी सभी श्रेणियाँ box ब्रीदिंग लौटाती हैं।

10. सुझाया गया शेड्यूल

GET /v1/affirmations/schedule

पैरामीटर:

• timezone (वैकल्पिक): सुझाए गए स्लॉट के लिए टाइमज़ोन लेबल, उदाहरण के लिए Europe/Berlin। डिफ़ॉल्ट UTC है।

📦 रिस्पॉन्स के उदाहरण

रैंडम अफर्मेशन:

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

पर्सनलाइज़्ड अफर्मेशन:

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

रीफ़्रेम किया गया विचार:

{
  "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
  }
}

वेलनेस बंडल:

{
  "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"]
  }
}

सुझाया गया शेड्यूल:

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

✨ मल्टी-फ़ॉर्मैट रिस्पॉन्स

रैंडम एंडपॉइंट JSON और प्लेन टेक्स्ट — दोनों में बोलता है। वेब और मोबाइल ऐप्स में पूरे स्ट्रक्चर्ड ऑब्जेक्ट के लिए ?format=json (डिफ़ॉल्ट) इस्तेमाल करें, या SMS फ़्लो, वॉइस असिस्टेंट और विजेट में भेजने के लिए तैयार स्ट्रिंग के लिए ?format=text।

🎯 किसके लिए बनाया गया

• डेवलपर्स जो वेलनेस ऐप्स, चैटबॉट और मोटिवेशन फ़ीचर बना रहे हैं और एक स्टेबल, अच्छी तरह डॉक्युमेंटेड API चाहते हैं।
• प्रोडक्ट मैनेजर्स जो डेली नोटिफ़िकेशन, स्ट्रीक्स और तयशुदा डेली कंटेंट से एंगेजमेंट बढ़ा रहे हैं।
• वेलनेस ऐप क्रिएटर्स जिन्हें बड़े पैमाने पर भरोसेमंद, श्रेणीबद्ध अफर्मेशन कंटेंट चाहिए।
• एंटरप्राइज़ टीमें जो Postman-रेडी ऑनबोर्डिंग के साथ स्केलेबल, SDK-शैली एंडपॉइंट की अपेक्षा करती हैं।

🌟 Affirmations API क्यों चुनें?

• डिज़ाइन से भरोसेमंद: स्टेबल ID, ट्रिम किया गया डेटा और स्पष्ट 404 का मतलब है प्रोडक्शन में कम आश्चर्य।
• जब ज़रूरत हो तब गहराई: 19 श्रेणियाँ जो anxiety relief से लेकर self-love तक सब कुछ कवर करती हैं।
• एक से ज़्यादा कॉल: पर्सनलाइज़ेशन, रीफ़्रेमिंग, ब्रीदिंग बंडल और शेड्यूलिंग — सब एक ही API में।
• डेवलपर फ़्रेंडली: सर्च, पेजिनेशन, बैचिंग, मल्टी-फ़ॉर्मैट रिस्पॉन्स, और इस्तेमाल के लिए तैयार स्निपेट।
• वेलनेस रेडी: रोज़ाना के सकारात्मक पलों के लिए कम-लेटेंसी रिस्पॉन्स के साथ 99.99% अपटाइम।

🚀 शुरुआत करें

• Postman कलेक्शन: हर एंडपॉइंट को एक क्लिक में एक्सप्लोर करने के लिए docs/affirmations-postman.json इम्पोर्ट करें।
• कोड स्निपेट: cURL, JavaScript और Python के लिए चलाने के लिए तैयार उदाहरण docs/affirmations-snippets.md से कॉपी करें।
• LLM-रेडी: docs/llms.txt AI एजेंट्स को API का स्ट्रक्चर्ड सारांश देता है।

आज ही सकारात्मक पल बनाना शुरू करें — तयशुदा डेली अफर्मेशन के लिए today एंडपॉइंट कॉल करें, फिर वेलनेस अनुभव पूरा करने के लिए पर्सनलाइज़ेशन और ब्रीदिंग बंडल जोड़ें।