مفتاح الموقع لـ WordPress

يحصل مكون AstroWay الإضافي لـ WordPress على المفتاح بنفسه، بدون تسجيل: يعرض الموقع إثباتًا على مسار REST الخاص به، ونحن نتحقق منه ونصدر مفتاحًا مرتبطًا بهذا الموقع.

كيف يتم التحقق

1. يقوم المكون الإضافي بإنشاء proof_id (UUID v4) و proof (32 بايت عشوائي في base64url، 43 حرفًا) ويحتفظ بهما لمدة 10 دقائق.
2. يعرض الموقع GET <home_url>/wp-json/astroway/v1/verify?nonce=<proof_id> مع Content-Type: application/json وجسم {"proof":"<proof>"}.
3. يرسل المكون الإضافي POST /v1/site-keys:

{ "site_url": "https://example.com", "proof_id": "3f1c2a9e-8b7d-4c1e-9f3a-2b6d5e4c1a07", "proof": "<43 characters>" }

site_url هو بالضبط home_url()، بدون ؟ و #. للروابط الثابتة البسيطة، مرر verify_url مع ؟rest_route=/astroway/v1/verify: يتم قبوله فقط على نفس الموقع وفقط كمسار.

ماذا يقدم المفتاح

• لخادم الموقع: يتلقى الطلب من المتصفح (مع ترويسة Origin) 403، ويجب أن يحدد كل استدعاء الموقع في X-AstroWay-Site-URL. يعتمد الربط على هذه الترويسة، لذا احتفظ بالمفتاح كسر، وإذا تسرب، احصل على مفتاح جديد: سيتم إلغاء المفتاح السابق؛
• مجموعة من القراءات المجانية، 300 استدعاء في الساعة لكل موقع، بدون أرصدة؛ يتم قبول الأبراج ذات التاريخ فقط بالقرب من تاريخ اليوم؛
• مفتاح واحد لكل تثبيت (المضيف والمسار الرئيسي)، حتى 5 تثبيتات لكل مضيف بساعة مشتركة.

الأخطاء: 400 INVALID_SITE_URL، 422 SITE_VERIFICATION_FAILED مع details.reason، 429 SITE_KEY_RATE_LIMIT مع retry_after.

ربط الحساب

عندما يرغب مالك الموقع في العمل على خطته الخاصة، يقوم المكون الإضافي بتحويل الموقع إلى مفتاح الحساب بنقرة واحدة.

1. يفتح المكون الإضافي في متصفح المسؤول https://api.astroway.info/dashboard/connect?site=<home_url>&return=<admin_url>&state=<16-128 حرفًا>&source=wp_plugin. يجب أن يكون return على نفس المضيف مثل site، وعلى https.
2. يقوم المسؤول بتسجيل الدخول أو التسجيل ويختار مفتاحًا للموقع أو ينشئ مفتاحًا جديدًا. يتم نقل المفتاح المرتبط بالفعل بنطاق آخر فقط بعد تأكيد منفصل.
3. يعود المتصفح إلى return مع code ونفس state. الإلغاء يعيد error=access_denied.
4. يقوم خادم الموقع بتبادل الكود، عن طريق إرسال مفتاح موقعه في X-Api-Key:

POST /v1/site-keys/connect/exchange
{ "code": "<43 characters>", "site_url": "https://example.com" }

الاستجابة: { "key": "aw_live_…", "plan": "free", "domain": "example.com", "account": "j***@example.com" }. الكود صالح لمدة 5 دقائق. يؤدي تبادل نفس الكود بنفس مفتاح الموقع مرة أخرى خلال 10 دقائق إلى إرجاع نفس الاستجابة. يتوقف مفتاح الموقع عن العمل بعد 24 ساعة من التبادل.

الأخطاء: 400 INVALID_CODE، 410 CODE_EXPIRED، 403 SITE_MISMATCH.