प्रोवाइडर के लिए Hido
इंटीग्रेशन गाइड · अंतिम अपडेट 8 नवंबर 2026
Hido बिना किसी बदलाव के V2Board, Xboard और XiaoV2Board पैनल के साथ काम करता है। यह पेज उन प्रोवाइडर के लिए है जो Hido की डिवाइस ID (HWID) से डिवाइस की संख्या सीमित करना चाहते हैं, या बदला हुआ पैनल चलाते हैं।
1. प्रोवाइडर कोड पाएँ
[email protected] पर ईमेल करें और साथ भेजें:
- आपकी सेवा का नाम और मनचाहा कोड (छोटे अक्षर और अंक, जैसे
abcvpn)। - पैनल का API पता, और बैकअप पते ताकि एक डोमेन ब्लॉक होने पर भी ग्राहक जुड़ सकें।
- सब्सक्रिप्शन डोमेन, अगर वह पैनल से अलग है।
- खरीदने का लिंक और सहायता चैनल, जो ऐप में अकाउंट → विवरण में दिखते हैं।
- बदले हुए पैनल के लिए, नीचे दी गई तालिका के विकल्प।
आप कभी भी डोमेन बदल सकते हैं। हमें बताइए, इंस्टॉल किए गए ऐप बिना अपडेट या दोबारा साइन इन के नए पते पर चले जाएँगे।
| विकल्प | कब चाहिए | डिफ़ॉल्ट |
|---|---|---|
api_path | आपका API /api/v1 में नहीं है, जैसे /api/v3। Hido साइन इन, अकाउंट और मिलने वाले सब्सक्रिप्शन लिंक के लिए यही पाथ इस्तेमाल करता है। | /api/v1 |
payload = header | आपका पैनल हर कॉल GET से लेता है, और JSON बॉडी base64url में X-Payload हेडर में आती है। | JSON बॉडी के साथ POST |
hido_client | आप API कॉल पर Hido को पहचानना चाहते हैं: तब ऐप हर कॉल पर, साइन इन सहित, Hido का User-Agent, X-Device और डिवाइस हेडर भेजता है। | बंद |
2. Hido क्या भेजता है
हर सब्सक्रिप्शन डाउनलोड पर
ये हेडर हमेशा भेजे जाते हैं, Happ और Remnawave वाले नामों के साथ, इसलिए जो पैनल उन ऐप के लिए पहले से डिवाइस सीमित करता है, वह Hido के साथ बिना बदलाव चलता है। जिस पैनल में डिवाइस सीमा नहीं है, वह इन्हें अनदेखा कर देता है।
| हेडर | उदाहरण |
|---|---|
x-hwid | 3f2a9c0d5e7b41a8c6d2e9f0a1b3c4d5 |
x-device-os | iOS, Android |
x-ver-os | 18.5 |
x-device-model | iPhone 16 |
x-device-locale | hi |
डाउनलोड का User-Agent कुछ ऐसा होता है: Hido/v2.0.5 clash.meta mihomo clash-verge Platform/ios। Clash Meta (mihomo) फ़ॉर्मेट दें, जैसे आप clash.meta क्लाइंट को देते हैं।
पैनल API कॉल पर (hido_client चालू होने पर)
| हेडर | उदाहरण |
|---|---|
User-Agent | Hido/v2.0.5 (iOS; 18.5) |
X-Device | iPhone 16: डिवाइस सूची के लिए पढ़ने में आसान नाम |
x-hwid | ऊपर वाली वही डिवाइस ID, बाकी डिवाइस हेडर के साथ |
Authorization | लॉगिन से लौटा auth_data |
GET /api/v1/user/getSubscribe HTTP/1.1
Authorization: Bearer …
User-Agent: Hido/v2.0.5 (Android; 15)
X-Device: Samsung SM-S928B
x-hwid: 3f2a9c0d5e7b41a8c6d2e9f0a1b3c4d5
x-device-os: Android
x-ver-os: 15
x-device-model: Samsung SM-S928B
x-device-locale: hi
डिवाइस ID के बारे में
- 32 छोटे हेक्साडेसिमल अक्षर, जो Remnawave के HWID नियमों में फ़िट होते हैं।
- फ़ोन की अपनी ID (Android ID, या iPhone और iPad पर एक Keychain आइटम) का एक-तरफ़ा हैश। असली ID कभी फ़ोन से बाहर नहीं जाती, और यह मान दूसरे ऐप के भेजे मान से मेल नहीं खाता।
- ग्राहक के Hido दोबारा इंस्टॉल करने पर भी वही रहता है, और हर डिवाइस का अलग होता है।
- ग्राहक इसे सेटिंग्स में देख और कॉपी कर सकते हैं, ताकि सहायता टीम आपकी डिवाइस सूची में उन्हें ढूँढ सके।
3. डिवाइस कहाँ गिनें
सब्सक्रिप्शन लिंक अक्सर शेयर होते हैं और दूसरे टूल उन्हें डाउनलोड करते हैं, इसलिए हम अकाउंट कॉल पर डिवाइस गिनने की सलाह देते हैं: हर डिवाइस को x-hwid से पहचानें और X-Device से नाम दें:
POST {api_path}/passport/auth/loginऔर/passport/auth/registerGET {api_path}/user/getSubscribe
प्रोवाइडर कोड से साइन इन किए अकाउंट के लिए Hido साइन इन के तुरंत बाद, हर सब्सक्रिप्शन अपडेट से पहले (हाथ से या अपने आप), ऐप खुलने पर और ऐप खुला रहने तक हर 30 मिनट में getSubscribe कॉल करता है। इसलिए डिवाइस गिना जाता है, भले ही आपका सब्सक्रिप्शन रूट डिवाइस न गिनता हो।
जो ग्राहक सिर्फ़ सब्सक्रिप्शन लिंक पेस्ट करते हैं (बिना साइन इन), वे केवल डाउनलोड पर डिवाइस हेडर भेजते हैं। उन्हें भी सीमित करने के लिए सब्सक्रिप्शन रूट पर भी गिनें।
4. Hido किन जवाबों को समझता है
Hido आपका message शब्दशः दिखाता है, इसलिए उसे ग्राहक की भाषा में लिखें और बताएँ कि आगे क्या करना है।
| आपका पैनल लौटाए | Hido क्या करता है |
|---|---|
403 के साथ {"code": "device_limit_exceeded", "message": "…"} | संदेश दिखाता है। साइन इन किया अकाउंट इस डिवाइस पर साइन आउट होता है और उसका कॉन्फ़िगरेशन हटता है। पेस्ट किया लिंक रहता है, पर अपडेट नहीं होता। |
429 के साथ {"code": "device_cooldown", "message": "…", "data": {"retry_after_minutes": 42}} | संदेश दिखाता है, अकाउंट रखता है और अपने आप दोबारा कोशिश नहीं करता। इंतज़ार का समय संदेश में लिखें। |
Authorization वाली कॉल पर 401, या बिना code के 403 | डिवाइस को साइन आउट मानता है: अकाउंट डिवाइस से हटता है और ग्राहक दोबारा साइन इन करता है। अकाउंट से हटाए गए डिवाइस के लिए इसका इस्तेमाल करें। |
सब्सक्रिप्शन जवाब का हेडर x-hwid-max-devices-reached: true या x-hwid-limit: true | Remnawave की तरह Hido का अपना डिवाइस-सीमा संदेश दिखाता है। |
5. लाइव होने से पहले जाँच
- Hido से साइन इन करें: डिवाइस पैनल में
X-Deviceवाले नाम के साथ दिखता है। - Hido दोबारा इंस्टॉल करके साइन इन करें: यह वही डिवाइस है, नया नहीं।
- प्लान की सीमा से ज़्यादा डिवाइस पर साइन इन करें: उस डिवाइस को आपका 403 संदेश मिलता है और वह साइन आउट होता है।
- पैनल में एक डिवाइस हटाएँ, फिर उस पर Hido में अपडेट दबाएँ: ग्राहक के दोबारा साइन इन करने तक अकाउंट उस डिवाइस से हट जाता है।
सवाल हों या अपने पैनल के लिए टेस्ट बिल्ड चाहिए: [email protected]।