WordPress के लिए साइट कुंजी

Last updated 29 सित॰ 2026 Markdown के रूप में देखें एजेंट सेटअप

AstroWay WordPress प्लगइन बिना रजिस्ट्रेशन के अपने आप कुंजी प्राप्त करता है: साइट अपने REST-मार्ग पर प्रमाण दिखाती है, हम उसे सत्यापित करते हैं और इस साइट से जुड़ी एक कुंजी जारी करते हैं।

सत्यापन कैसे होता है

प्लगइन proof_id (UUID v4) और proof (base64url में 32 रैंडम बाइट्स, 43 वर्ण) जनरेट करता है और उन्हें 10 मिनट तक रखता है।
साइट GET <home_url>/wp-json/astroway/v1/verify?nonce=<proof_id> को Content-Type: application/json और {"proof":"<proof>"} बॉडी के साथ लौटाती है।
प्लगइन 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, details.reason के साथ 422 SITE_VERIFICATION_FAILED, retry_after के साथ 429 SITE_KEY_RATE_LIMIT।

खाता कनेक्ट करना

जब साइट का मालिक अपनी योजना पर काम करना चाहता है, तो प्लगइन एक क्लिक में साइट को खाता कुंजी पर स्विच कर देता है।

प्लगइन एडमिनिस्ट्रेटर के ब्राउज़र में https://api.astroway.info/dashboard/connect?site=<home_url>&return=<admin_url>&state=<16-128 वर्ण>&source=wp_plugin खोलता है। return उसी होस्ट पर होना चाहिए जिस पर site है, और https पर होना चाहिए।
एडमिनिस्ट्रेटर लॉग इन या रजिस्टर करता है और साइट के लिए एक कुंजी चुनता है या एक नई बनाता है। एक कुंजी, जो पहले से ही किसी अन्य डोमेन से जुड़ी हुई है, केवल एक अलग पुष्टि के बाद ही स्थानांतरित की जाती है।
ब्राउज़र code और उसी state के साथ return पर लौटता है। रद्द करने पर error=access_denied लौटता है।
साइट सर्वर 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।