Reports API - 16 تقرير PDF جاهز بعلامتك التجارية
أنت ترسل تاريخ الميلاد، وتحصل على مستند جاهز. ليس JSON تحتاج إلى تحويله إلى PDF، بل PDF نفسه: مُنسق صفحة بصفحة، بشعارك، باسم تقريرك دون أي إشارة لنا داخله.
ستة عشر تقريرًا من هذا النوع تعمل بالفعل. مع المُدير، سجل الصادرات وخمس روايات AI هذا 23 مسارًا تحت /v1/reports/*.
الفهرس
Section titled “الفهرس”كل سطر يحتوي على عينة جاهزة. هذا ليس مجرد قالب: الملف يُولد بنفس الاستدعاء الموجود في دليل هذه النقطة النهاية، ويُعاد إصداره مع القوالب.
عدد الصفحات هو ما أعطى إياه هذا العينة، مقاسًا في 2026-09-21. يتراوح حسب الخريطة: كلما زادت الجوانب زادت الصفحات، وrelocation يضيف صفحتين‑ثلاث صفحات لكل مدينة (4 صفحات لمدينة واحدة، 13 لخمسة مدن).
| نقطة النهاية | ما بداخلها | عدد الصفحات | الكريدتات | عينة |
|---|---|---|---|---|
/v1/reports/natal | الثلاثة الكبيرة، الكواكب، البيوت، الجوانب | 3 | 5 000 | |
/v1/reports/synastry | جوانب بين خريطتين، توازن العناصر | 2 | 5 000 | |
/v1/reports/transit-yearly | توقعات العبور للعام المختار | 5 | 5 000 | |
/v1/reports/relocation | الخريطة الأصلية، حتى 5 مدن، كواكب غيرت بيتها، خطوط قريبة، 19 مجال حياة | 6 | 5 000 | |
/v1/reports/vedic-kundli | لاجنا ونكشترا، مواقع سيدييرية، ماهادشي فيمشتاري | 2 | 5 000 | |
/v1/reports/lal-kitab | كيسمت، تيفا، رينات مكتشفة، أوباي | 2 | 5 000 | |
/v1/reports/gemstone | توصية بالأحجار مع التمائم، الأحجار التي لا تُلبس، حالة الذنوب | 7 | 5 000 | |
/v1/reports/human-design | معايير رئيسية، مراكز، قنوات | 2 | 5 000 | |
/v1/reports/muhurta | أيام ملائمة مرتبة لنشاط واحد | 4 | 5 000 | |
/v1/reports/love | نقاط حب رئيسية، الثلاثة الكبيرة، الجوانب | 2 | 5 000 | |
/v1/reports/career | نقاط مهنية رئيسية، سياق الشخصية، الجوانب | 2 | 5 000 | |
/v1/reports/money | نقاط مالية رئيسية، بيوت، جوانب | 3 | 5 000 | |
/v1/reports/business | نقاط عمل رئيسية، بيوت، جوانب | 2 | 5 000 | |
/v1/reports/child | سمات شخصية رئيسية، الثلاثة الكبيرة، كواكب | 2 | 5 000 | |
/v1/reports/stellaforge | ملصق خريطة بصفحة واحدة: كواكب، توازن، جوانب رئيسية | 1 | 5 000 | |
/v1/reports/tarot | وصف للترتيب والبطاقات | 2 | 100 | |
/v1/reports/vastu | مخطط منزل مع ماندالا، تقييم، اكتشافات فاستو مع مصادر وتصحيحات | 2 | 5 000 |
تاروت أرخص بـ 50 مرة لأنه لا يحتوي على إيفيميريس: صفحة واحدة من الترتيب بدون حسابات فلكية.
العمق: standard أو extended
Section titled “العمق: standard أو extended”/v1/reports/natal (و /v1/reports/generate مع report_type: "natal") يقبل depth. standard هو المستند المذكور أعلاه، 5000 كريدت. extended يكلف 10000 كريدت ويضيف عجلة الخريطة وقسمًا لكل جسم من الشمس إلى بلوتو، هيرون والأساندنت في البرج: اثنا عشر قسمًا، كل قسم من صفحتين إلى أربع صفحات من نص مُحرر (عينة PDF، 13 صفحة) من نفس المجموعة التي تُعيد /v1/natal-texts. لا شيء يُولد عند الطلب، لذا نفس الخريطة تعطي نفس المستند.
الأقسام متوفرة بـ 20 لغة، بلغات الموقع؛ depth: "extended" بلغة أخرى يرد بخطأ 400، ولا يُملأ بلغة أخرى. الأنواع الأخرى من التقارير لا تزال لها عمق واحد: أقسامها الطويلة لم تُكتب بعد.
مسار واحد بدل ستة عشر
Section titled “مسار واحد بدل ستة عشر”POST /v1/reports/generate يقبل حقل report_type ويفعل نفس ما يفعله المسار المنفصل. هناك اثنا عشر نوعًا: natal, transit-yearly, synastry, business, career, love, money, child, lal-kitab, human-design, tarot, vedic-kundli.
بالنسبة للـ SDK هذا طريقة واحدة بدل اثنا عشر، بالنسبة للـ MCP أداة واحدة بدل اثنا عشر. السعر نفسه: الاستدعاء عبر المُدير يخصم نفس عدد الكريدتات كما لو كان استدعاءً مباشرًا.
PDF أم HTML
Section titled “PDF أم HTML”افتراضيًا يُرجع PDF ورابطه. ?format=html يُعيد صفحة HTML جاهزة مباشرة في الاستجابة، بدون رندرة ولا تخزين: مفيد عندما تُدمج التقرير في صفحتك أو تريد إضافة CSS خاص.
رابط PDF يبقى 24 ساعة. لإعطاء العميل رابطًا لفترة أطول، أضف ?retain_days=30 (حتى 90): الملف سيبقى بهذه المدة، وexpires_at في الاستجابة سيظهر ذلك. نحن لا نستضيف مستندات أطول من ذلك، لكن يمكنك حذف الملف مبكرًا عبر DELETE /v1/reports/files/{filename} مجانًا. الملف يحتوي على ما أرسلت، مع الاسم، لذا مدة التخزين موصوفة في DPA، القسم 2. GET /v1/reports/history يُظهر آخر الصادرات لهذا المفتاح مجانًا، والسجل المنتهي يأتي مع expired: true.
علامتك التجارية، لا علامتنا
Section titled “علامتك التجارية، لا علامتنا”whitelabel يقبل كائنًا من 15 حقلًا: companyName, companyUrl, companyEmail, companyMobile, companyBio, logoUrl, frontImage, reportName, footerText, fontPairing وخمس ألوان (themeColor, headingColor, textPrimaryColor, textSecondaryColor, backgroundColor).
يمكن تمريره مباشرة في الطلب، وبالتالي لا تحتاج أي إعدادات حساب:
curl -X POST https://api.astroway.info/v1/reports/natal \ -H "X-Api-Key: aw_live_..." \ -H "Content-Type: application/json" \ -d '{ "chart": { "date": "1990-05-15", "time": "14:30:00", "timezoneOffset": 3, "latitude": 50.45, "longitude": 30.52 }, "whitelabel": { "companyName": "Zoryana Studio", "reportName": "Your Birth Blueprint", "themeColor": "#7c3aed", "footerText": "zoryana.example" } }'في المستند المُولد يظهر اسم الاستوديو، عنوان التقرير الخاص، لون التمييز في عناوين الأقسام وتذييلك. لا توجد كلمة AstroWay فيه أبداً.
بديل لأولئك الذين لا يريدون تكرار الكائن في كل طلب: whitelabel: true يأخذ الإعدادات المحفوظة في الحساب. اضبطها في صفحة تخصيص تقارير في لوحة التحكم: اسم الشركة، اسم التقرير، جهات الاتصال، الشعار ولونين، مع معاينة عينة تقرير الناتال. نفس الإعدادات متاحة بالمفتاح عبر /v1/whitelabel/config و /v1/whitelabel/logo، وPOST /v1/whitelabel/preview يرسم عينة في PDF. الحقل المرسل في الكائن له أولوية أعلى من المحفوظ.
تطبيق جاهز يمكن استنساخه
Section titled “تطبيق جاهز يمكن استنساخه”عرض حي والكود على GitHub، MIT.
سيناريو عملي: بيانات العميل على اليسار، PDF جاهز على اليمين. كل بلاطة تقرير تُظهر السعر بالكريدت قبل النقر وتؤدي إلى العينة الجاهزة. تفعيل الـ white‑label يكون عبر علامة اختيار. الخلفية هي مسار واحد بدون تبعيات، لأن جوهرها أن المتصفح لا يستطيع الوصول إلى الـ API مباشرة، لذا المفتاح يُخزن على الخادم.
git clone https://github.com/astroway/starter-practicecd starter-practice && npm installcp .env.example .env # your key goes herenpm run devأربع أشياء يجب إزالتها. السعر يُظهر حيث يُتخذ القرار: الخادم يُعيد X-Credits-Used إلى الصفحة، وليس فقط في السجل. ستة عشر تقريرًا لديها أربع صيغ طلب، وليس ستة عشر. نفس الطلب مرة ثانية يكلف صفر لأن التخزين المؤقت يُعيد نفس الملف. وALLOWED_REPORTS يحدّ ما سيُسمح للنسخة بتوليد: العرض العام يُولد فقط ترتيب تاروت (/v1/reports/tarot, 100 كريدت)، لأن الصفحة العامة على الإنترنت التي تُنشئ تقرير ناتال (/v1/reports/natal, 5 000) لأي شخص تُستنزف الحد الشهري المجاني بعد نقرتين.
اللغات
Section titled “اللغات”حقل language يقبل 21 رمزًا. تم ترجمة ثلاث بالكامل: الأوكرانية، الإنجليزية، الروسية. بالنسبة للثمانية عشر المتبقية تُترجم أسماء الأبراج فقط، بينما العناوين والشروحات تبقى بالإنجليزية: التقرير الألماني سيكتب “Löwe” تحت عنوان “Planets”.
نكتب هذا صراحةً لأن التقرير هو مستند يبقيه عميلك لنفسه. بيع تقرير ألماني مع أسماء أبراج ألمانية في العينة سيكون اكتشافًا غير سارة للعميل، وليس لنا. تقرير muhurta لا يزال إنجليزيًا بالكامل.
عدد التقارير التي ينتجها الخطة
Section titled “عدد التقارير التي ينتجها الخطة”/v1/reports/natal وبقية ملفات PDF تكلف 5 000 كريدت، لذا يتحول الحد الشهري للخطة إلى عدد التقارير ببساطة:
| الخطة | كريدت/شهر | تقارير PDF | تقارير تاروت |
|---|---|---|---|
| Free | 10 000 | غير متاحة | غير متاحة |
| Indie, $5 | 50 000 | 10 | 500 |
| Starter, $19 | 200 000 | 40 | 2 000 |
| Pro, $59 | 800 000 | 160 | 8 000 |
| Business, $199 | 3 500 000 | 700 | 35 000 |
| Reports Pack, $99 | 1 500 000 | 300 | 15 000 |
في الخطة Free التقارير مغلقة عمدًا: PDF واحد يستهلك ثوانٍ من عمل Chrome من جانبنا، والخطة المجانية لا تغطي ذلك. أقل دخول هو Indie بـ $5.
Reports Pack هو إضافة منفصلة لمن يحتاج فقط تقارير: $99 شهريًا، 1 500 000 كريدت، أي 300 PDF بـ 33 سنتًا لكل واحدة، مع white‑label. هذا أرخص من PDF في Pro لأن المفتاح لا يذهب إلى أي مكان سوى التقارير. مفتاح هذه الخطة يستخدم فقط في /v1/reports/* و /v1/whitelabel/*.
إعادة بيع التقارير: كم يكلفك PDF
Section titled “إعادة بيع التقارير: كم يكلفك PDF”إذا كنت تبيع التقارير لعملائك، الرقم الوحيد المهم هو: كم يكلفك PDF واحد على حجمك. ضمن حد الخطة هذا هو سعر الخطة مقسومًا على عدد PDF. فوق الحد كل PDF يُحسب كـ overage يُحتسب لكل 10 000 كريدت فوق الحد، لذا PDF بـ 5 000 كريدت يكلف نصف سعر الـ overage.
| الخطة | PDF في الخطة | سعر PDF ضمن الحد | كل PDF فوق |
|---|---|---|---|
| Indie, $5 | 10 | $0.50 | $2.50 |
| Starter, $19 | 40 | $0.48 | $2.50 |
| Pro, $59 | 160 | $0.37 | $1.50 |
| Reports Pack, $99 | 300 | $0.33 | $1.50 |
| Business, $199 | 700 | $0.28 | $1.00 |
إذن أرخص خطة تعتمد على عدد PDF التي تبيعها شهريًا، مع الـ overage مشمولًا:
| PDF شهريًا | أرخص خطة | تكلفتك | لكل PDF |
|---|---|---|---|
| 10 | Indie | $5 | $0.50 |
| 40 | Starter | $19 | $0.48 |
| 100 | Pro | $59 | $0.59 |
| 160 | Pro | $59 | $0.37 |
| 300 | Reports Pack | $99 | $0.33 |
| 500 | Business | $199 | $0.40 |
| 700 | Business | $199 | $0.28 |
نقاط التحول: Starter يصبح أفضل من Indie بعد 16 PDF، Pro أفضل من Starter بعد 57، Reports Pack أفضل من Pro بعد 187، إذا لم تحتاج سوى تقارير، Business أفضل من Reports Pack بعد 367. Pro و Business يفتحان باقي الـ API، بينما Pack يقتصر على التقارير وwhite‑label.
أنت تحدد الهامش. في 300 PDF ضمن Reports Pack تكلفتك $99 شهريًا. بـ $9 لكل وحدة تحصل على إيراد $2700 مقابل $99 تكلفة، بـ $19 تحصل على $5700. لا ننصح بسعر التجزئة، لكن الحساب يبقى نفسه: سعرك ناقص 33 سنتًا.
التقرير الناتال الموسع يكلف ضعف التقرير القياسي، لذا في كل خطة أعلى يكون السعر مضاعفًا للـ PDF: $0.66 في Reports Pack.
هناك أمران يقللان من التكلفة الفعلية أكثر. طلب مكرر بنفس البيانات يُعيد نفس الملف من التخزين المؤقت ولا يكلف شيئًا، لذا العميل الذي يحمل التقرير مرتين يُدفع مرة واحدة فقط. والخطة السنوية هي 12 شهرًا بسعر 9، وReports Pack يصبح $0.25 لكل PDF.
قبل البيع، افتح العينات: كل واحدة هي نفس الملف الذي تُعيده الـ API، ومع whitelabel يصبح اسمك وألوانك محل الاسماء النموذجية.
إذا كنت تحتاج نصًا وليس مستندًا
Section titled “إذا كنت تحتاج نصًا وليس مستندًا”خمسة نقاط نهاية تُعيد رواية AI كـ JSON، بدون تنسيق وبدون PDF: /v1/reports/ai/natal-narrative, /transit-narrative, /synastry-narrative, /year-ahead-narrative, /monthly-narrative. كل واحدة بـ 250 كريدت. خذها عندما يكون النص يُدمج في تخطيطك الخاص، تطبيقك أو النشرة.
التقرير الناتال يدعم وضعًا مختلطًا: enrich: true يضيف رواية AI داخل PDF. على نفس الخريطة التجريبية هذا يضيف 5 صفحات بدلًا من 3.