API
DiMaker API колдонуп, жеке маалыматтар камтылган файлдарды түзүп, аларды керектүү учурда алуучуларга жеткирүүгө болот. API сурамдары башка серверден же веб-браузер аркылуу (CORS аркылуу) аткарылышы мүмкүн.
Кайдан баштоо керек
«Интеграция» - «API Токендери» бөлүмүнөн коопсуздук токенин алып, аны колдонууну уруксат кылуу керек. Ошондой эле, жеке маалыматтарды камтыган өзгөрмөлөрдү камтыган документ түзүү, электрондук почтага жөнөтүү үчүн каттын шаблонун даярдоо жана даяр файлдар үчүн Дискке папка түзүү талап кылынат.
Файл түзүү
Файлдарды түзүү үчүн төмөнкү дарекке POST-DATA, POST- же GET сурамдарын жөнөтүү зарыл
https://dimaker.app/api/v1/create/
Сурамдын кодировкалоосу – UTF-8. Милдеттүү талаалар жылдызча менен белгиленет.
-
secure*
Токен (сап, 36 символ)
-
doc_id*
Файлды түзүү үчүн колдонулуучу документтин ID (сап, 36 символ). Документ ачылган учурда дарек сабынан алса болот. Документ «Корзина» ичинде болбошу керек, бирок ал Документтердин каалаган башка папкасында болушу мүмкүн.
-
mask*
Алмаштырыла турган өзгөрмөлөрдү камтыган сап. Ключ (өзгөрмө) жана байланышкан маанини (алмаштыруу үчүн текстти) камтыйт. Бул көп файлдарды түзүүгө маалымат камтуусу мүмкүн.
Бир файлга үлгү:
[{"%name": "Иванов", "%баллы":"100"}]
Бир нече файл үчүн үлгү:
[{"%name": "Иванов", "%баллы":"100"}, {"%name": "Петров", "%баллы":"200"}, {"%name": "Сидоров", "%баллы":"300"}]
Электрондук почта дарегин көрсөтүү үчүн %email, файл атын белгилөө үчүн %filename колдонуу керек. Эгер бир нече электрондук почта дарегине жөнөтүү зарыл болсо, аларды үтүр менен бөлүп көрсөтүңүз. %email{} биринчи дарегин негизги катары көрсөтөт.
Ал эми сүрөттөрдү шилтеме (http:// же https://) аркылуу же Base64 коддолгон сүрөт катары көрсөтсө болот. Base64 сүрөттөр үчүн саптын башы «data:image/» болушу зарыл. -
mail_id
Электрондук почтага жөнөтүү үчүн кат шаблондун ID номери (сап, 36 символ). Эгерде бул өзгөрмө берилбесе, кат жөнөтүлбөйт.
- ...
Жыйынтык
Сервер сурамга жооп катары сапты кайтарат, төмөнкү маалыматтарды камтыйт:
-
result
Сурамдын жыйынтыгы. Төмөнкүлөрдү кабыл алат:
error - Сурам катасы. Файлдар түзүлгөн эмес.
success - Файлдарды ийгиликтүү түзүү. Файлдардын даяр болгону жөнүндөгү билдирүүнү берүү же алуу жөнүндө маалыматты көргөзсө болот. - ...
Ушул сыяктуу толтурса болот:
{
"result":"success",
"create_id":"b4caf05b-6757-4d9c-b4bc-1924a9b31796",
"url":"https://embed.dimaker.app/widgets/get/927ebf68-2f55-4b20-a18c-c1171ee113db/b4caf05b-6757-4d9c-b4bc-1924a9b31796/",
"files":[
"369dc61e-40c2-46c0-81f4-e31ca8c33cc2",
"d94c6efb-0076-438b-bb84-fead9c1ae556",
"716e1081-c8ee-442b-b0b0-0681b2ed5d90"
]
}
Бир сурам менен бир нече файл түзүү
Менен мүнөздөлгөн ж.б. тексти киргизүү түшүндүрмөсү талабыңызга ылайык киргизилет