API
DiMaker API का उपयोग करके व्यक्तिगत डेटा के साथ फाइलें बनाई जा सकती हैं और ज़रूरत पड़ने पर उन्हें प्राप्तकर्ताओं को भेजा जा सकता है। API रिक्वेस्ट किसी अन्य सर्वर से या ब्राउज़र से CORS रिक्वेस्ट के माध्यम से की जा सकती है।
शुरुआत कैसे करें
“इंटीग्रेशन” – “API टोकन” सेक्शन में जाकर एक सुरक्षित टोकन प्राप्त करें और उसका उपयोग सक्षम करें। इसके अलावा, एक डॉक्यूमेंट बनाएं जिसमें व्यक्तिगत डेटा के लिए वेरिएबल्स हों, ईमेल भेजने के लिए टेम्पलेट सेट करें, और तैयार फाइलों के लिए ड्राइव पर एक फोल्डर बनाएं।
फाइलों का निर्माण
फाइलें बनाने के लिए POST-DATA, POST- या GET रिक्वेस्ट को इस पते पर भेजें:
https://dimaker.app/api/v1/create/
नीचे दिए गए डेटा के साथ।
रिक्वेस्ट की एन्कोडिंग UTF-8 है। अनिवार्य फील्ड्स को तारे (*) से चिह्नित किया गया है।
-
secure*
टोकन (36 कैरेक्टर का स्ट्रिंग)
-
doc_id*
डॉक्यूमेंट की ID (36 कैरेक्टर का स्ट्रिंग) जिसका उपयोग फाइल बनाने के लिए किया जाएगा। यह ID, डॉक्यूमेंट खोले जाने पर एड्रेस बार में दिखती है। डॉक्यूमेंट ट्रैश में नहीं होना चाहिए, लेकिन यह अन्य किसी भी फोल्डर में हो सकता है।
-
mask*
स्ट्रिंग जिसमें सभी वेरिएबल्स, उनके की (वेरिएबल) और वैल्यू (रिप्लेसमेंट टेक्स्ट) के रूप में हों। एक फाइल के उदाहरण के लिए:
[{"%name": "शर्मा", "%अंक":"100"}]
कई फाइलों के लिए:
[{"%name": "शर्मा", "%अंक":"100"}, {"%name": "वर्मा", "%अंक":"200"}, {"%name": "सिंह", "%अंक":"300"}]
ईमेल के लिए %email और फाइल के नाम के लिए %filename का उपयोग करें।
Base64 में एन्कोडेड इमेज अपलोड करने के लिए "data:image/" से शुरू होने वाली स्ट्रिंग का उपयोग करें। -
mail_id
ईमेल टेम्पलेट की ID (36 कैरेक्टर की स्ट्रिंग)। अगर यह वेरिएबल नहीं भेजा गया तो ईमेल नहीं भेजी जाएगी।
-
email_send
फाइल भेजने का समय। वैल्यूज हो सकती हैं:
onfinish - सभी फाइल बनने के बाद भेजें (डिफ़ॉल्ट)
oncreate - फाइल बनते ही भेजना शुरू करें।
timeout - निश्चित समय के बाद भेजें। इसके लिए दो और पैरामीटर आवश्यक हैं:
email_timeout_value - समय (संख्या)
email_timeout_unit - यूनिट "m" (मिनट), "h" (घंटे), "d" (दिन)।
या Unix time फॉर्मेट में email_timeout_timestamp भेजें। -
folder_id
ड्राइव फोल्डर की ID (36 कैरेक्टर की स्ट्रिंग) जहां फाइल सेव करनी है। अगर फोल्डर नहीं है, तो पहली फाइल बनने पर इसे स्वतः बनाया जाएगा।
-
page_id
डॉक्यूमेंट के एक से अधिक पन्नों के लिए (पहले पन्ना - 0)। सभी पन्नों को ',' से अलग करके भेजें।
-
result
परिणाम को किस फॉर्मेट में वापस लाना है:
स्ट्रिंग
लिंक - बनी हुई फाइल का लिंक
फाइल - फ़ाइल को सीधे लौटाएं।
परिणाम
सर्वर स्ट्रिंग देगा, जिसमें निम्नलिखित हो सकते हैं:
-
result
परिणाम:
error - रिक्वेस्ट में गलती।
success - सफलतापूर्वक फाइल बनाई गई। -
create_id
ID। अन्य API रिक्वेस्ट के लिए उपयोगी।
-
files
ID की सूची। इससे फाइल डाउनलोड हो सकती है।
मल्टीपल फाइल जनरेशन
एक ही रिक्वेस्ट में कई फाइलें बनाना संभव है। डॉक्यूमेंट ID एक ऐरे के रूप में भेजें।
ऑटोमैटिक ईमेल
दोस्तरे ईमेल टेम्पलेट पहले से सेट करें।
फाइल डिलीशन
इसके लिए API को DELETE रिक्वेस्ट भेजें।