نقاط نهاية المتصفح
نقاط النهاية التي تستدعيها متصفحات زوارك مباشرة للنماذج وروبوت الدردشة وعدّادات مشاهدات الصفحات.
تُرجمت هذه الصفحة من الإنجليزية. وفي حال وجود أي اختلاف، تسري النسخة الإنجليزية. اقرأ بالإنجليزية
لا تأخذ نقاط النهاية هذه أي رمز. يقبل Atlas الطلب فقط عندما تكون ترويسة Origin فيه هي أصل موقع بيئتك المسجَّل؛ وأي شيء آخر يحصل على 403 ORIGIN_DENIED. ويقتصر CORS على ذلك الأصل.
https://<delivery host>/v1/public/environments/{environmentId}النماذج
Section titled “النماذج”| الطريقة والمسار | الغرض |
|---|---|
GET /forms/{formKey} |
تعريف النموذج وإعداداته والتحدي المراد عرضه |
POST /forms/{formKey}/submissions |
الإرسال. انظر النماذج والعملاء المحتملون لمتن الطلب |
روبوت الدردشة
Section titled “روبوت الدردشة”| الطريقة والمسار | الغرض |
|---|---|
GET /bots/{botKey} |
المظهر والمشغّلات |
POST /bots/{botKey}/conversations |
البدء: { path?, challengeToken? } → { conversationId, secret, messages } |
POST /bots/{botKey}/conversations/{id}/messages |
الإرسال: { secret, text? (≤ 1,000 chars), choice?, challengeToken? } |
يطلب 428 BOT_CHALLENGE_REQUIRED من المتصفح إكمال Turnstile وإعادة المحاولة. ويظهر 409 CONVERSATION_FULL بعد 80 رسالة. تتولى أداة الدردشة كل ذلك نيابةً عنك.
مشاهدات الصفحات
Section titled “مشاهدات الصفحات”POST /analytics/views مع { "path": "/about" } يعيد 204. أرسله بعد كل تحميل صفحة وتنقل من جهة العميل باستخدام fetch(…, { keepalive: true }). تخطَّ المعاينات والروبوتات.
يخزّن Atlas عدّادات يومية لكل مسار فقط: لا ملفات تعريف ارتباط، ولا عناوين IP، ولا معرّفات زوار.