API दस्तावेज़ीकरण – एकीकरण गाइड

URL मॉडल

dice83 के पास कोई पारंपरिक REST API नहीं है जो JSON लौटाता हो। हर URL एक पूरा HTML पेज प्रस्तुत करता है जिसमें अनुरोधित टूल पहले से कॉन्फ़िगर होता है। इसके बाद आपका ब्राउज़र Web Cryptography API का उपयोग करके स्थानीय रूप से यादृच्छिक परिणाम जनरेट करता है। इसका मतलब है कि कोई सर्वर-साइड कम्प्यूटेशन नहीं होता और HTTP पर dice83 से यादृच्छिक मान प्राप्त करने का कोई तरीका नहीं है।

इस मॉडल की शक्ति: हर URL एक स्वतंत्र, साझा करने योग्य, बुकमार्क करने योग्य टूल कॉन्फ़िगरेशन है। सही पथ बनाएँ, और टूल आपके सटीक पैरामीटर्स के साथ लोड हो जाता है। इसे लिंक्स, वर्कशीट्स, प्रेजेंटेशन्स, iframes, या QR कोड में उपयोग करें।

URL संरचना

https://dice83.com / {lang} / {tool} / {params...}
https://dice83.com / de / integer / 5 / 1 / 100
^^ ^^^^^^^ ^ ^ ^^^
lang tool count min max

भाषा उपसर्ग वैकल्पिक है। अंग्रेज़ी के लिए इसे छोड़ दें। टूल नाम जनरेटर का चयन करता है। पैरामीटर्स स्लैश-विभाजित मान हैं जो टूल को कॉन्फ़िगर करते हैं। URL में अनुपस्थित पैरामीटर्स उचित डिफ़ॉल्ट मानों का उपयोग करते हैं।

त्वरित उदाहरण

तुरंत एक पूर्व-कॉन्फ़िगर टूल पेज पाने के लिए ये URL बनाएँ:

/coin/10 एक साथ 10 सिक्के उछालें

/integer/1/1000 1 से 1000 के बीच यादृच्छिक पूर्णांक

/integer/5/-50/50 -50 से 50 के बीच पाँच यादृच्छिक पूर्णांक

/password/24 24-अक्षर का सुरक्षित पासवर्ड

/4d6kh3 4d6 रोल करें, उच्चतम 3 रखें (क्षमता अंक)

/pattern/LLL-DDDD QXR-4829 जैसी यादृच्छिक स्ट्रिंग

/color/5/rgb RGB फ़ॉर्मेट में पाँच यादृच्छिक रंग

/groups/24/4 24 प्रतिभागियों को 4 टीमों में बाँटें

/de/2d6 जर्मन इंटरफ़ेस के साथ 2d6 रोल करें

/100 1 से 100 के बीच यादृच्छिक संख्या

रूट संदर्भ

नीचे सूचीबद्ध हर रूट एक वैकल्पिक 2-अक्षर भाषा उपसर्ग स्वीकार करता है। तिरछे में लिखे पैरामीटर पथ खंड हैं। रेंज स्लैश विभाजकों का उपयोग करती हैं, जो ऋणात्मक मानों को सक्षम करता है।

मूल & निर्णय उपकरण

/coin एक सिक्का उछालें

/coin/count COUNT सिक्के उछालें (1-1000)

/yes-no यादृच्छिक हाँ या नहीं

/true-false यादृच्छिक बूलियन

/left-right यादृच्छिक दिशा

/rps पत्थर, कागज़, या कैंची

/dice-face एकल यूनिकोड पासा फेस ⚀-⚅

सुरक्षा

/password/length यादृच्छिक पासवर्ड (डिफ़ॉल्ट 16, अधिकतम 256)

/diceware/words EFF शब्दसूची से पासफ़्रेज़ (डिफ़ॉल्ट 6, अधिकतम 20)

/pin/length अंकीय PIN (डिफ़ॉल्ट 4, अधिकतम 20)

संख्या जनरेटर

/integer/min/max रेंज में यादृच्छिक पूर्णांक (ऋणात्मक समर्थित)

/integer/count/min/max रेंज में एकाधिक पूर्णांक

/numbers/count/min/max अद्वितीय गैर-दोहराव वाले पूर्णांक

/sequence/min/max रेंज को यादृच्छिक क्रम में शफ़ल करें

/decimal/count/decimals 0 से 1 के बीच यादृच्छिक भिन्न

/percent/decimals 0% से 100% के बीच यादृच्छिक प्रतिशत

/ratio/parts 100 का योग करने वाले यादृच्छिक अनुपात

/prime/min/max रेंज में यादृच्छिक अभाज्य संख्या

/fibonacci यादृच्छिक फ़िबोनाची संख्या

/binary/bits यादृच्छिक बिटस्ट्रिंग (अधिकतम 64)

/bytes/count/format hex, base64, या bin में कच्चे बाइट्स

/even/min/max यादृच्छिक सम पूर्णांक (ऋणात्मक समर्थित)

/odd/min/max यादृच्छिक विषम पूर्णांक (ऋणात्मक समर्थित)

स्ट्रिंग्स & अक्षर

/generate/length अल्फ़ान्यूमेरिक स्ट्रिंग (अधिकतम 256)

/uuid RFC 4122 अनुसार UUID v4

/unicode/count यादृच्छिक मुद्रण योग्य यूनिकोड अक्षर

/letter/count यादृच्छिक अक्षर (भाषा-संवेदनशील)

/ascii यादृच्छिक मुद्रण योग्य ASCII (33-126)

/emoji/count यादृच्छिक इमोजी

/roman/min/max यादृच्छिक रोमन अंक

/pattern/template टेम्पलेट से कस्टम स्ट्रिंग (L, l, D, H)

समय & तिथि

/calendar यादृच्छिक तिथि के साथ दृश्य वार्षिक ग्रिड

/date/from/to वर्ष रेंज में यादृच्छिक तिथि

/time/min/max घंटा रेंज में यादृच्छिक समय

/duration/min/max मिनटों में यादृच्छिक अवधि

/timestamp/year यादृच्छिक Unix टाइमस्टैम्प

/week यादृच्छिक ISO सप्ताह 1-52

/month यादृच्छिक महीना (स्थानीयकृत)

/weekday सप्ताह का यादृच्छिक दिन (स्थानीयकृत)

/season यादृच्छिक ऋतु

अंतर्राष्ट्रीय डेटा (ब्राउज़र Intl API)

/timezone यादृच्छिक IANA टाइमज़ोन + UTC ऑफ़सेट

/currency यादृच्छिक ISO 4217 मुद्रा

/language यादृच्छिक विश्व भाषा

/country/count ध्वजों के साथ यादृच्छिक देश

दृश्य & रंग

/color/count/format यादृच्छिक रंग (hex, rgb, hsl)

/gradient यादृच्छिक दो-रंग CSS ग्रेडिएंट

/palette/harmony सामंजस्यपूर्ण पैलेट (पूरक, अनुरूप, त्रय, एकवर्णी)

/pixel/size/colors यादृच्छिक पिक्सेल आर्ट ग्रिड

/avatar ज्यामितीय आइडेंटिकॉन SVG

/wavelength यादृच्छिक दृश्य स्पेक्ट्रम तरंगदैर्ध्य

संगठनात्मक

/order/count COUNT प्रतिभागियों के लिए यादृच्छिक बारी क्रम

/pairs/count COUNT प्रतिभागियों की यादृच्छिक जोड़ी

/groups/count/m COUNT को M यादृच्छिक समूहों में बाँटें

/bracket/count टूर्नामेंट ब्रैकेट सीडिंग

/grid/rows/cols ग्रिड से यादृच्छिक सेल

/winner/count दृश्य प्रकटीकरण के साथ COUNT में से एक चुनें

/countdown/min/max यादृच्छिक काउंटडाउन टाइमर (मिनट)

डेटासेट

/element यादृच्छिक आवर्त सारणी तत्व

/planet यादृच्छिक सौरमंडल ग्रह

/note यादृच्छिक संगीत स्वर (क्रोमैटिक)

/zodiac/system यादृच्छिक राशि चिह्न (पश्चिमी या चीनी)

/tarot/count 78-कार्ड टैरो डेक से निकालें

/rune यादृच्छिक एल्डर फ़ुथार्क रून

/iching यादृच्छिक I Ching हेक्साग्राम

/nato यादृच्छिक NATO ध्वन्यात्मक कोड

वितरण

/gaussian/mean/stdev सामान्य (बेल कर्व) वितरण

/weighted/w1/w2/w3... भारित चयन (अधिकतम 5 भार)

जनरेटिव आर्ट

/blob/count जैविक SVG ब्लॉब आकार

/wave/count SVG वेव सेक्शन डिवाइडर

/noise/size प्रक्रियात्मक नॉइज़ टेक्सचर

/mandala/count सममित रेडियल पैटर्न

/spirograph हाइपोट्रोकॉइड वक्र

/voronoi/count वोरोनोई टेसेलेशन

/delaunay/count डेलॉने त्रिभुजीकरण

/terrain/size भूस्थलाकृतिक समोच्च मानचित्र

/lsystem/count L-सिस्टम शाखा संरचना

/halftone/count हाफ़टोन डॉट पैटर्न

/moire मोआरे व्यतिकरण पैटर्न

/guilloche गणितीय रेखा जाल

/lines/count नॉइज़-विस्थापित समानांतर रेखाएँ

/stipple/count भारित डॉट स्कैटर

डिज़ाइन उपकरण

/proportion यादृच्छिक शास्त्रीय अनुपात (स्वर्ण, मूल-2, आदि)

/rating/count यादृच्छिक स्टार रेटिंग (आधा-तारा सटीकता)

/checker/cols/rows यादृच्छिक रंगों वाला चेकरबोर्ड

/matrix/cols/rows असममित ग्रिड विभाजन

गतिशील रूट

/NdS पासा अभिव्यक्ति: /d20, /2d6, /4d6kh3, /d8+5

/N त्वरित यादृच्छिक संख्या 1 से N: /100, /20

/N/M दो संख्याएँ: 1-N और 1-M: /100/500

/N/M/K तीन संख्याएँ: /100/200/300

पासा अभिव्यक्ति व्याकरण

पासा अभिव्यक्तियाँ URL पथ से पार्स की जाती हैं। पूर्ण व्याकरण:

# Format [N]d<SIDES>[kh|kl<KEEP>][!][+|-<MOD>] # Examples d6 # एक छह-फलकीय पासा 2d6 # दो छह-फलकीय पासे, जोड़ें 4d6kh3 # 4d6 रोल करें, उच्चतम 3 रखें 2d20kl1 # 2d20 रोल करें, न्यूनतम 1 रखें d6! # विस्फोटक d6 (अधिकतम पर पुनः रोल, जोड़ें) 2d6+3 # 2d6 जमा 3 d20-2 # d20 घटा 2 4d6kh3+2 # सभी संयुक्त

पैरामीटर सीमाएँ

N (पासों की संख्या): 1 से 100। SIDES: 2 से 1,000,000। KEEP: 1 से N। MOD: -10,000 से +10,000।

अमान्य अभिव्यक्तियाँ चुपचाप 1d6 पर वापस आ जाती हैं।

भाषा उपसर्ग

हर रूट एक वैकल्पिक 2-अक्षर ISO 639-1 उपसर्ग स्वीकार करता है जो इंटरफ़ेस भाषा सेट करता है। जब कोई उपसर्ग नहीं होता तो अंग्रेज़ी डिफ़ॉल्ट होती है।

enzhjakohiesarfritptbnruuridtrvi

भाषा उपसर्ग UI लेबल, स्थानीयकृत आउटपुट (महीने के नाम, सप्ताह के दिनों के नाम, ब्राउज़र Intl API के माध्यम से देशों के नाम), और SEO टैग को प्रभावित करता है। यह कभी भी यादृच्छिकता इंजन या पैरामीटर सीमाओं को प्रभावित नहीं करता।

/ko/letter यादृच्छिक कोरियाई अक्षर

/ja/month जापानी में यादृच्छिक महीने का नाम

/de/integer/1/100 जर्मन इंटरफ़ेस, पूर्णांक 1-100

/fr/zodiac/western फ़्रेंच इंटरफ़ेस, पश्चिमी राशि

पैरामीटर नियम

स्लैश-विभाजित रेंज

सभी रेंज पैरामीटर URL में / विभाजकों का उपयोग करते हैं। यह ऋणात्मक मानों को सक्षम करता है: /integer/-10/10। रेंज सामान्यीकृत होती हैं ताकि छोटा मान पहले आए। /integer/100/5 चुपचाप /integer/5/100 बन जाता है।

डिफ़ॉल्ट

हर पैरामीटर का एक उचित डिफ़ॉल्ट मान होता है। सादे रूट मान्य हैं: /integer का डिफ़ॉल्ट 1-100, /password का डिफ़ॉल्ट 16 अक्षर, /percent का डिफ़ॉल्ट 0 दशमलव स्थान होता है। छोड़े गए पैरामीटर कभी त्रुटि उत्पन्न नहीं करते।

क्लैम्पिंग

सभी पैरामीटर सैनिटाइज़, टाइप-कास्ट, और सुरक्षित रेंज में क्लैम्प किए जाते हैं। सीमा से अधिक मान चुपचाप क्लैम्प कर दिए जाते हैं। अज्ञात पैरामीटर अनदेखे किए जाते हैं। श्वेतसूचीबद्ध रूट्स के लिए कोई URL इनपुट त्रुटि पेज उत्पन्न नहीं करता।

क्वेरी स्ट्रिंग्स त्यागी जाती हैं

सर्वर केवल पथ-आधारित पैरामीटर प्राप्त करता है। किसी भी URL में जोड़ी गई क्वेरी स्ट्रिंग्स रूटिंग के दौरान चुपचाप त्याग दी जाती हैं। /coin?count=50 बिल्कुल /coin की तरह ही व्यवहार करता है। URL पथ ही एकमात्र और पूर्ण इंटरफ़ेस है।

एकीकरण

Iframe एम्बेडिंग

किसी भी टूल को iframe में एम्बेड करें। टूल फ़्रेम के भीतर पूरी तरह रेंडर होता है और पैरेंट पेज विज़िटर के ब्राउज़र एन्ट्रॉपी का उपयोग करके परिणाम जनरेट करता है।

<iframe src="https://dice83.com/coin/5" width="100%" height="600"></iframe>

सीधे लिंक

किसी भी पूर्व-कॉन्फ़िगर टूल को लिंक करें। प्राप्तकर्ता आपके द्वारा निर्दिष्ट सटीक कॉन्फ़िगरेशन देखते हैं और अपने स्वतंत्र परिणाम जनरेट करते हैं।

<a href="https://dice83.com/integer/5/1/100">5 संख्याएँ जनरेट करें</a>
<a href="https://dice83.com/groups/24/4">6 की 4 टीमें बनाएँ</a>
<a href="https://dice83.com/4d6kh3">क्षमता अंक रोल करें</a>

वर्कशीट्स & प्रेजेंटेशन्स

कक्षा की वर्कशीट्स या प्रेजेंटेशन स्लाइड्स पर सीधे URL प्रिंट करें। छात्र किसी भी ब्राउज़र में पथ टाइप करें। हर छात्र स्वतंत्र परिणाम जनरेट करता है। dice83.com/coin/100 जैसे URL हाथ से टाइप करने के लिए काफ़ी छोटे हैं।