Formularët
Formularët e regjistrimit, njerëzit që i plotësojnë dhe shifrat e tyre.
Veglat e formularëve
| Vegla | Çfarë bën |
|---|---|
| listForms | Formularët e regjistrimit të hapësirës së punës, nga i ndryshuari më së fundi, me statusin, regjistrimet dhe shikimet e tyre. |
| getForm | Një formular i plotë: fushat, tekstet, audiencat, konfirmimi i dyfishtë dhe njoftimet e tij. Një formular i publikuar shton lidhjen, kodin e ngulitjes dhe adresën ku dërgon të dhënat një formular HTML i thjeshtë, dhe includeDesign e kthen skicën si JSON. |
| listFormStarters | Pikat e nisjes nga të cilat mund të fillojë një formular i ri, me fushat që kërkon secila. |
| createForm | Krijoni një formular nga një pikë nisjeje, nga një dizajn i shkruar si document, ose nga një pikë nisjeje me ndryshime sipër saj, me çfarëdo cilësimesh. Mbetet skicë përveç nëse publish është true. |
| updateForm | Ndryshoni emrin dhe cilësimet e një formulari, që zbatohen menjëherë, ose dizajnin e skicës së tij përmes document. Tekstet dhe stili bashkohen çelës pas çelësi, dhe fields zëvendëson gjithë listën. |
| publishForm | Bëjeni skicën aktuale atë që shohin vizitorët, që formulari të pranojë regjistrime. |
| setFormStatus | Pezulloni një formular të publikuar, ose hapeni sërish. |
| duplicateForm | Kopjoni një formular në një skicë të re, pa regjistrimet e tij. |
| deleteForm | Fshini përgjithmonë një formular dhe regjistrimet e tij. Lidhja dhe ngulitjet e tij pushojnë së funksionuari, dhe njerëzit që shtoi mbeten në kontaktet tuaja. |
| getFormAnalytics | Shikimet, regjistrimet, njerëzit e shtuar dhe ata ende në pritje, si edhe shkalla e konvertimit gjatë një periudhe, gjithsej dhe për minutë, orë ose ditë. Shikimet ruhen orë për orë. |
| listFormSubmissions | Njerëzit që plotësuan një formular, nga më i riu, me përgjigjet dhe statusin e tyre, një faqe në herë. Kërkoni sipas adresës së emailit dhe filtroni sipas statusit. |
| getFormSubmission | Një regjistrim i plotë: çdo përgjigje, statusi i tij, kur mbërriti dhe kur u shtua personi, faqja nga erdhi dhe audiencat e tij. |
| approveFormSubmission | Shtoni një regjistrim që pret konfirmimin e tij pa emailin e konfirmimit. Kërkon edhe contacts:write. |
| resendFormConfirmation | Dërgojini me email një lidhje të re konfirmimi një regjistrimi që ende pret. Nuk dërgohet asgjë kur ky formular i ka dërguar email asaj adrese në dhjetë minutat e fundit, ose kur adresa ka marrë pesë nga kjo hapësirë pune në ditën e fundit. Kërkon edhe emails:send. |
| removeFormSubmissions | Fshini deri në 200 regjistrime të një formulari sipas id-së. Kontaktet dhe audiencat mbeten siç janë. |
Leximi kërkon forms:read dhe çdo ndryshim kërkon forms:write. Çdo gjë që e bën një formular të dërgojë postë kërkon edhe emails:send: aktivizimi i konfirmimit të dyfishtë, caktimi i dërguesit ose i emailit të konfirmimit, publikimi ose hapja e një formulari me konfirmim të dyfishtë, dhe ridërgimi i një konfirmimi. Një klient që vepron për një anëtar sheh vetëm formularët që krijoi ai anëtar, dhe një klient i kufizuar në disa adresa mund të dërgojë konfirmime vetëm nga adresat që arrin, dhe mund të njoftojë vetëm ato.
Dizajnimi i një formulari nga një përshkrim i shkruar bëhet në bisedën e aplikacionit. Përmes MCP, dizajneri është klienti: kaloni fushat, tekstet dhe stilin si document te createForm ose updateForm, dhe veglat e rregullojnë dizajnin dhe tregojnë çfarë ndryshuan.
Shtatë mjete në këtë server bëjnë një ndryshim që REST API e mbron me kod verifikimi, dhe kërkojnë të njëjtin kod: createRule, setRuleEnabled, removeDomain, removeDomainAddress, removeAppHost, deleteForm dhe deleteAudience për një audiencë që keni krijuar. Derisa klienti të ketë verifikuar një kod në 60 minutat e fundit, ose personi të ketë zgjedhur Lejo ndryshimet për 60 minuta për të te Llogaria → Aplikacionet e lidhura, një mjet i tillë përgjigjet me një rezultat që nis me Refused (step_up_required): dhe nuk ndryshon asgjë. emptyAudience nuk kërkon kurrë kod. Faqja Autentikimi e API-t tregon si kërkohet dhe verifikohet një kod.
Veglat zbatojnë të njëjtat rregulla dhe refuzime si REST API, dhe faqet /forms të referencës së API-së përshkruajnë çdo fushë. listForms rendit sipas ndryshimit të fundit, dhe createForm e updateForm rregullojnë një document të pjesshëm, ndërsa API-ja e merr të tërë.
