API
DiMaker API orqali shaxsiy ma'lumotlardan iborat fayllarni yaratib, kerak bo'lganda ularni oluvchilarga yuborishingiz mumkin. API so‘rovlari boshqa serverdan yoki CORS orqali brauzerdan amalga oshirilishi mumkin.
Qaerdan boshlash kerak
"Integratsiya" – "API tokenlari" bo‘limiga o‘tib, xavfsiz Secure tokenni olish va undan foydalanishga ruxsat berish kerak. Shuningdek, shaxsiy maʼlumotlar uchun o‘zgaruvchilarni, elektron pochta xabari andozasini va tayyor fayllar uchun Diskda papka yaratish kerak.
Fayllarni yaratish
Fayllar yaratish uchun quyidagi manzilga POST-DATA, POST- yoki GET so'rovlarini yuborishingiz kerak
https://dimaker.app/api/v1/create/
so‘rov formatida ko‘rsatilgan maʼlumotlar bilan.
Kodlash UTF-8 formatida amalga oshiriladi. Majburiy maydonlar yulduzcha bilan belgilangan.
-
secure*
Token (aynan 36 belgidan tashkil topgan matn)
-
doc_id*
Hujjatning ID raqami (aynan 36 belgidan iborat matn). Ushbu ID hujjat ochilganda manzil satridan ko‘rish mumkin. Hujjat «Qayta ishlash savatida» bo'lmasligi kerak, lekin har qanday hujjatlar papkasida joylashgan bo'lishi mumkin.
-
mask*
formatidagi qator, unda kalit (o'zgaruvchi) va qiymat (matn) sifatida o‘zgartirilishi kerak bo‘lgan o‘zgaruvchilar mavjud bo‘ladi. Bir nechta fayl yaratish uchun cheklovlarsiz ma'lumotlarni ko'rsatishingiz mumkin.
Bir fayl uchun misol:
[{"%name": "Ivanov", "%ball":"100"}]
Bir nechta fayl uchun misol:
[{"%name": "Ivanov", "%ball":"100"}, {"%name": "Petrov", "%ball":"200"}, {"%name": "Sidorov", "%ball":"300"}]
Elektron pochta uchun %email, fayl nomi uchun esa %filename kalitlarini foydalaning. Ko‘p pochtaga yuborish uchun manzillarni vergul bilan ajrating. Dastlabki pochta manzili fayl yuborilganligini ko‘rsatadi.
Kalit uchun qiymatda qo'shtirnoq bo'lsa, ular qochirilishi kerak.Suratni berish uchun to‘g‘ridan-to‘g‘ri havola (http:// yoki https://) yoki Base64 formatida kodlangan rasmdan foydalanishingiz mumkin. Base64 formatida bo‘lsa, qator "data:image/" bilan boshlanishi kerak.
Alternativ usul
Agar -qatordan foydalanish imkoniyati bo‘lmasa, o‘zgaruvchi maydonlarni so‘rov maydonlari sifatida jo‘natishingiz mumkin. Maydonlar "mask_" prefiksi bilan boshlanib, buning orqasidan o‘zgaruvchiga mos keladi. Masalan, mask_name maydoni %name o‘zgaruvchiga mos keladi. Elektron pochta uchun %mask_email, fayl nomi uchun esa %mask_filename prefikslarini kiritishingiz kerak. -
mail_id
Email andoza ID (aynan 36 belgidan tashkil topgan matn). Email yuborilishini istamasangiz, ushbu o‘zgaruvchini kiritmasangiz bo‘ladi.
-
email_send
Pochta yuborish vaqti. Quyidagi qiymatlardan birini qabul qilishi mumkin:
onfinish - Hamma fayl yaratib bo‘lingandan keyin yuboradi (standart)
oncreate - Fayl yaratib bitgandan keyin darhol yuborish
timeout - Ko‘rsatilgan muddatda yuborish.
email_timeout_value va email_timeout_unit kiritilishi kerak:- m (daqiqa)
- h (soat)
- d (kun)
-
folder_id
Fayllar saqlanadigan Disk papka ID (36 belgidan iborat matn). Papka mavjud bo‘lmasa, birinchi fayl yaratishda avtomatik yaratiladi.
-
page_id
Agar hujjatda bir nechta varaqlar bo‘lsa, foydalaniladigan varaqlarning tartib raqamlari. Masalan: 0 - birinchi varaqqa mos keladi.
-
result
Natijani qaytarish formatini aniqlaydi:
- yo‘qligi. qatori qaytariladi
- link. Yaratilgan faylga havola qaytariladi
- file. Agar so‘rov muvaffaqiyatli bo‘lsa, tayyor fayl qaytariladi.