Анықтама орталығы

Tilda API

Tilda-дағы жобаны өзіңіздің веб-сайтыңызбен автоматты түрде біріктіру

Барлық сұраулар әдеттегі GET әдісі арқылы жіберіледі. Жауап JSON пішімінде қайтарылады.

Сәтті жауап:

{ "күй": "табылды", ...}

Қате жауап:

{ "күй": "ҚАТЕ", ... }

Сұраныс саны бойынша шектеу бар: сағатына 150 сұраныс.

API тілде жасалған мазмұнды сайтпен синхрондау үшін қажет. Tilda серверімен байланысуға және сіздің сайтқа кіруші кірген сайын деректерді алуға тыйым салынады.

Барлық мазмұнды серверге толығымен көшіру керек (суреттерді, сценарийлерді және стильдерді қоса) және одан пайдаланушыларға тарату. Егер сіз біздің серверлерімізге үнемі хабарласып тұруға байланысты жүктеме жасасаңыз, тіркелгіңіз бұғатталып, API функциясы өшіріледі.

Синхрондау логикасын дұрыс ұйымдастырған кезде 1-3 соққы (жарияланған бетте) болуы керек, сондықтан серверге сағатына 150 рет кіру жеткілікті. Синхрондаудан кейін бетке өзгертулер енгізілгенше ешқандай хит болмайды, содан кейін ақпаратты қайта синхрондау қажет болады.

Серверде Tilda функцияларын пайдалану ережелері мен шектеулері

Жұмыстың басталуы

API өзара әрекеттесу тек Бизнес-жоспар үшін қолжетімді екенін ескеріңіз. Алдымен сіз ашық кілт пен құпия кілтті алуыңыз керек. Мұны жеке тіркелгіңіздің API бөлімінде жасауға болады: Сайт параметрлері → Экспорт → API.

Сұраныс тізімі

Жобалар тізімі
/v1/getprojectslist

Жоба туралы ақпарат
/v1/getprojectinfo

Жобадағы беттердің тізімі
/v1/getpageslist

Бет туралы ақпарат (+ негізгі html коды)
/v1/getpage

Бет туралы ақпарат (+толық бет html-коды)
/v1/getpagefull

Экспортталатын бет ақпараты (+ негізгі html коды)
/v1/getpageexport

Экспортқа арналған бет ақпараты (+ толық бет html коды)
/v1/getpagefullexport

Барлық сұраулардың мекенжайы: https://api.tildacdn.info
Әрбір сұрауда айнымалы мәндерді беру керек: ашық кілт және құпия кілт және сұрауға, жобаға немесе бетке байланысты қосымша

Жеке тіркелгіңізде «Экспорт» қойындысындағы әрбір жобаның параметрлерінде кескіндер ( export_imgpath ), js ( export_jspath ) және css ( export_csspath ) файлдарының жол мәндерін көрсетуге болады.
Осылайша, сіздің міндетіңіз сервердегі беттердің толық көшірмесін жасау болса, серверде сақталатын файлдарға қатысты немесе абсолютті жолдарды орнатуға болады.

Серверде синхрондауды жылдам орналастыруға арналған PHP кітапханасы

Жобалар тізімін алыңыз

URL мекенжайы алу үшін:
https://api.tildacdn.info/v1/ getprojectslist /?publickey=00000000000000000000&secretkey=00000000000000000000

URL сұрауын алу:

https://api.tildacdn.info/v1/getprojectslist/?publickey=00000000000000000000&secretkey=00000000000000000000

JSON жауабы:

{ "күй": "ТАБЫЛДЫ", "нәтиже": [ { "id": "0", "атауы": "Бірінші жоба", "дескрипт": "Кейбір ақпарат" }, { "id": "1" , "title": "Екінші жоба", "decr": "" }, ... ] }

Жоба туралы ақпарат алыңыз

URL сұрауын алу:
https://api.tildacdn.info/v1/ getprojectinfo /?publickey=000000000000000000000&secretkey=00000000000000000000 &projectid=0

URL сұрауын алу:

https://api.tildacdn.info/v1/getprojectinfo/?publickey=00000000000000000000&secretkey=00000000000000000000&projectid=0

JSON жауабы:

{ "күй": "ТАБЫЛДЫ", "нәтиже": { "id": "0", "атауы": "Жоба атауы", "дескр": "", "customdomain": "project.ru", "export_csspath" ": "", "export_jspath": "", "export_imgpath": "", "indexpageid": "0", "customcsstext": "y", "favicon": "", "page404id": "0", "суреттер": [ { "қайдан": "", "кейін": "" } ... ] } }

Веб-серверге арналған конфигурация файлының мысалын алу үшін, htaccess немесе nginx мәні бар сұрау жолына webconfig параметрін қосыңыз.

Nginx пайдаланылған жағдайда, алынған мысал серверіңіздің конфигурация файлының сервер бөліміне орналастырылуы керек.

Жобадағы беттердің тізімін алыңыз

GET сұрау жолы:
https://api.tildacdn.info/v1/ getpageslist /?publickey=000000000000000000000&secretkey=00000000000000000000 &projectid=0

GET сұрау жолы:

https://api.tildacdn.info/v1/getpageslist/?publickey=00000000000000000000&secretkey=00000000000000000000&projectid=0

JSON жауабы:

{ "күй": "табылды", "нәтиже": [ { "id": "1001", "жоба": "0", "атауы": "бірінші бет тақырыбы", "түсініктеме": "", "img ": "", "featureimg": "", "бүркеншік ат": "", "күн": "16.05.2014 14:45:53", "сұрыптау": "80", "жарияланған": "1419702868 ", "файл аты": "page1001.html" }, { "id": "1002", "жоба": "0", "атауы": "Бет тақырыбы екінші", "дескр": "", "img" : "", "featureimg": "", "бүркеншік ат": "", "күн": "17.05.2014 10:50:00", "сұрыптау": "90", "жарияланған": "1419702277" , "файл аты": "page1002.html" }, ... ] }

Бет туралы ақпаратты алыңыз
+ негізгі html коды

GET сұрау жолы:
https://api.tildacdn.info/v1/ getpage /?publickey=000000000000000000000&secretkey=0000000000000000000 &pageid=1001

GET сұрау жолы:

https://api.tildacdn.info/v1/getpage/?publickey=00000000000000000000&secretkey=00000000000000000000&pageid=1001

JSON жауабы:

{ "күй": "табылды", "нәтиже": { "id": "1001", "жоба": "0", "атауы": "бет тақырыбы", "дескрипт": "", "img": "", "featureimg": "", "бүркеншік ат": "", "күн": "2014-05-16 14:45:53", "сұрыптау": "80", "жарияланған": "1419702868", "html": "кейбір html бет коды", "файл аты": "page1001.html", "js": [ ... ], "css": [ ... ] } }

Бет туралы ақпаратты алыңыз
+ толық html коды

GET сұрау жолы:
https://api.tildacdn.info/v1/ getpagefull /?publickey=00000000000000000000&secretkey=0000000000000000000 &pageid=1001

GET сұрау жолы:

https://api.tildacdn.info/v1/getpagefull/?publickey=00000000000000000000&secretkey=00000000000000000000&pageid=1001

JSON жауабы:

{ "күй": "табылды", "нәтиже": { "id": "1001", "жоба": "0", "атауы": "бет тақырыбы", "дескрипт": "", "img": "", "featureimg": "", "бүркеншік ат": "", "күн": "2014-05-16 14:45:53", "сұрыптау": "80", "жарияланған": "1419702868", "html": "кейбір html бет коды", "файл аты": "page1001.html" } }

Экспортталатын бет туралы ақпаратты алыңыз
+ негізгі беттің html-коды

GET сұрау жолы:
https://api.tildacdn.info/v1/ getpageexport /?publickey=00000000000000000000&secretkey=0000000000000000000 &pageid=1001

GET сұрау жолы:

https://api.tildacdn.info/v1/getpageexport/?publickey=00000000000000000000&secretkey=00000000000000000000&pageid=1001

JSON жауабы:

{ "күй": "табылды", "нәтиже": { "id": "1001", "жоба": "0", "атауы": "бет тақырыбы", "дескрипт": "", "img": "", "featureimg": "", "бүркеншік ат": "", "күн": "2014-05-16 14:45:53", "сұрыптау": "80", "жарияланған": "1419702868", "суреттер": [ { "кейін": "", "кейін": "" }, { "кейін": "", "кейін": "" }, { "кейін": "", "кейін": " " } ], "html": "файлдарға жергілікті сілтемелері бар негізгі бет html-коды", "файл аты": "page1001.html" } }

Маңызды: Бұл әдісті шақырған кезде осы бетке арналған статикалық файлдарды (скрипттер мен мәнерлер) жаңартылып отыру үшін серверде қосымша қайта сақтауды ұсынамыз. Бұл файлдардағы өзгерістер үнемі орын алады және файлдар нұсқасының жаңартылған-жаңармағаны туралы ақпарат алу үшін API пайдалану жұмыс істемейді.

Экспортталатын бет туралы ақпаратты алыңыз
+ толық бет html-коды

GET сұрау жолы:
https://api.tildacdn.info/v1/ getpagefullexport /?publickey=00000000000000000000&secretkey=00000000000000000000 &pageid=1001

GET сұрау жолы:

https://api.tildacdn.info/v1/getpagefullexport/?publickey=00000000000000000000&secretkey=00000000000000000000&pageid=1001

JSON жауабы:

{ "күй": "табылды", "нәтиже": { "id": "1001", "жоба": "0", "атауы": "бет тақырыбы", "дескрипт": "", "img": "", "featureimg": "", "бүркеншік ат": "", "күн": "2014-05-16 14:45:53", "сұрыптау": "80", "жарияланған": "1419702868", "суреттер": [ { "кейін": "", "кейін": "" }, { "кейін": "", "кейін": "" }, { "кейін": "", "кейін": " " } ], "html": "файлдарға жергілікті сілтемелері бар толық бет html-коды", "файл аты": "page1001.html" } }

Вебхук (немесе кері қоңырау)

Синхрондауды автоматты түрде орындау үшін Жариялау түймесін басқан сайын хабарландыруы бар сұрау жіберілетін сценарий мекенжайын көрсетуге болады. Осылайша мазмұнды жаңартуға және серверге жаңа беттерді қосуға болады.

Вебхукқа сілтеме жобаңыздың API бөлімінде көрсетілуі мүмкін: Сайт параметрлері → Экспорттау → API:

Хабарлама GET әдісі арқылы жіберіледі.
Параметрлер: беттік, жобалық, жарияланған, ашық кілт

Жауап ретінде сіз сұрауды алғаныңызды растауыңыз керек.
Сәтті сұрауға күтілетін жауап: жарайды
(PHP-де жай ғана «ok» жаңғырығы;)

Егер Tilda сервері күтілетін жауапты алмаса, серверді қайта сұраудың тағы екі әрекеті болады (барлығы 3 сұрау).

Сұраныс бірден жіберілмейді, бірақ жарияланғаннан кейін 1 минуттан 20 минутқа дейін кешіктіріледі. Сондықтан, егер сұрау бірден келмесе, онда оның көрсетілген уақытта келмегеніне көз жеткізу керек.

Маңызды: серверден жауап күтудің ең көп уақыты 5 секунд. Жауап алынбаса, байланыс тоқтатылады. Сондықтан сіз бұл хабарландыруды тек өзіңізге тіркеп , содан кейін ғана синхрондауды орындаңыз, мысалы, cron арқылы. Әдетте, егер сізде бетте көп суреттер болса, бұл уақыт жеткіліксіз.

қалай

Мысал қолдану жағдайлары

Tilda API-ді пайдаланудың екі негізгі сценарийі бар: экспорттау процесін автоматтандыру, сервердегі барлық жоба файлдарын сақтау қажет болғанда және Tilda-да жасалған беттерді сайт үлгілерімен біріктіру қажет болғанда.

Жобадағы барлық беттерді экспорттау

Біздің міндетіміз жобаны біздің тіркелгімізде Tilda-да жарияланған серверде толығымен сақтау.

Жеке кабинетте жоба параметрлерінде «Экспорттау» қойындысында біз кескіндерге, JS және CSS файлдарына жолдарды белгілейміз. Мысалы, /суреттер, /js және /css
Бізге қажет жобаның жобасы есімізде
Біз серверде API сұрауларын орындайтын, файлдарды жасайтын және оларға ақпарат жазатын сценарий жасаймыз
Серверде қалталарды жасаңыз (суреттер, js, css), біз файлдарды көшіреміз

Біз getprojectinfo сұрауы арқылы қажетті жоба туралы ақпаратты аламыз.
Сұраудан алынған кескіндер массивін айналдыру. Ол файлдардың тізімін қамтиды. From айнымалысында - бастапқы файлдың мекенжайы, to - файл сақталуы керек жергілікті атау. Біз файлдарды қажетті орындарға көшіреміз. Бұл файлдар жобаның барлық беттеріне ортақ.
Егер webconfig параметрі алдыңғы сұрауға қосылған болса, .htaccess файлын жасаңыз және оған webconfig айнымалысының мазмұнын жазыңыз немесе бұл мазмұнды nginx веб-серверінің конфигурация файлының сервер бөліміне қосыңыз.
Біз getpageslist сұрауы бар жобадағы барлық беттердің тізімін аламыз.
Алынған беттер тізімін айналдырыңыз. Әрбір бет үшін:

getpagefullexport сұрауы бар бетті экспорттау үшін ақпарат алу;
біз серверде бетте қолданылатын кескіндерді, сценарийлерді және стильдерді сақтаймыз ( images , js және css массивтерінен);
бет файлын жасаңыз ( файл аты айнымалысында файл атауы) және оған html айнымалысының мазмұнын жазыңыз.

Егер сіздің тапсырмаңыз Tilda парақтарын шаблоныңызға біріктіру болса (мұнда үстіңгі деректеме, мәзір, төменгі деректеме және т.б. бар), онда процедура бірдей, жай ғана сұрауды пайдаланыңыз.getpageexport. Ол үлгінің мазмұн аймағына енгізуге болатын негізгі html кодын қайтарады. Бұл жағдайда үлгіге сценарийлер мен стильдерді қолмен енгізу керек екенін есте ұстаған жөн.

Суреттер мен js/css файлдарын көшірусіз интеграция

Егер сізде жоғары жүктемелі жоба болмаса және файлдарды көшірумен айналысқыңыз келмесе, негізгі html кодын қайтаратын getpage сұрауын пайдаланыңыз. Суреттер Tilda серверінен жүктеледі. Ең бастысы, үлгіге JS және CSS файлдарын қосуды ұмытпаңыз. Олардың тізімі js және css айнымалыларында бірдей сұрау нәтижесінде қайтарылады.

PHP тіліндегі қарапайым сұраныстың мысалы:

$нәтиже = file_get_contents('https://api.tildacdn.info/v1/getprojectinfo/?publickey=000000000000000000000&secretkey=00000000000000000000&projectid=0'); $жоба = json_decode($нәтиже, шын); print_r($жоба);

Пайдаланушы келісіміне сәйкес, API арқылы экспорттау функциясын пайдаланған кезде, сіз https://tilda.cc дереккөзіне міндетті гиперсілтемемен әрбір экспортталған бетте «Тілдада жасалған» идентификаторын дербес көрсетуіңіз керек.