Juhend · 7 min lugemist
Vormiehitaja API ja automatiseerimise juhend
Uuendatud 2026-09-17
Lühidalt
Vormiehitaja API lubab tavaliselt luua ja hallata vorme API-võtmega REST-i kaudu, saada teavitusi uutest vastustest signeeritud webhookide kaudu pollimise asemel, ning üha sagedamini pakub MCP-serverit, et tehisintellekti agendid saaksid vorme otse luua ja lugeda.
Kui vorm on rohkem kui ühekordne, tahad seda tavaliselt ühendada millegi muuga: skriptiga, mis loob vorme programmiliselt, süsteemiga, mis reageerib kohe, kui vastus saabub, või tehisintellekti agendiga, mis ehitab ja muudab vorme osana laiemast töövoost. See juhend käib läbi kolm osa, mis selle võimalikuks teevad: API ise, webhookid reaalajas teavituste jaoks ja MCP tehisintellekti agentide ligipääsuks.
Autentimine API-võtmega
API-võtmetega kaitstud REST API on standardne viis skriptida vormide loomist, loetleda vastuseid või tõmmata andmeid teise süsteemi ilma brauseri seansita. Hoia võti serveripoolel; kõik, mis brauserisse saadetakse, on sisuliselt avalik.
OpenAPI spetsifikatsioon (masinloetav kirjeldus igast otspunktist) lubab genereerida kliendi teegi sinu valitud keeles, selle asemel et HTTP-päringuid käsitsi kirjutada, ning seda kasutavad ka enamik API-testimistööriistu päringute automaatseks täitmiseks.
Mida v1 REST API tavaliselt katab
Oota otspunkte vormide loomiseks ja uuendamiseks, vastuste loetlemiseks ja üksiku vastuse toomiseks, ning vormi põhiseadistuse haldamiseks. Versioonihalda API-t algusest peale (v1, v2), et tulevased katkestavad muudatused ei rikuks vaikimisi praeguse versiooni vastu ehitatud skripte.
Webhookid reaalajas uuenduste jaoks
API pollimine taimeriga uute vastuste kontrollimiseks raiskab päringuid ja lisab viivitust. Webhook lükkab andmed sinu otspunkti kohe, kui vastus saabub, mis on nii kiirem kui odavam kui pollimine.
Signeeritud webhookid (HMAC-SHA256 on levinud standard) lasevad su otspunktil kontrollida, et sisu tuli tõesti vormiplatvormilt ega ole võltsitud, ning automaatsed uued katsed tarnimise ebaõnnestumisel tähendavad, et lühike katkestus sinu poolel ei kaota vastust vaikimisi.
CSV-eksport ja Slacki teavitused
Mitte iga integratsioon ei vaja kohandatud koodi. CSV-eksport katab ad hoc analüüsi tabelarvutuses ning Slacki teavitus uutest vastustest katab levinud vajaduse, kus meeskonnakanal soovib lihtsalt näha vastuste saabumist, ilma midagi ehitamata.
MCP: tehisintellekti agentidele otsene juurdepääs vormidele
MCP (Model Context Protocol) on viis, kuidas tehisintellekti koodiagendid nagu Claude Code, Cursor või ChatGPT saavad tööriistu otse kutsuda, selle asemel et inimene kopeeriks API vastuseid edasi-tagasi. Vormiplatvorm, mis pakub MCP-serverit, lubab agendil luua vormi, lugeda vastuseid või kohandada seadeid osana laiemast ülesandest, kasutades sama alusliggujat API-t, kuid standardiseeritud liidese kaudu, mida agent juba oskab kutsuda.
See muutub üha olulisemaks meeskondadele, kes ehitavad sisemisi tööriistu tehisintellekti agentidega: selle asemel et kirjutada kohandatud API integratsioonikoodi ühekordse vormiülesande jaoks, suunad agendi MCP-serverile ja kirjeldad, mida soovid.
YeetFormi REST API v1 (dokumentatsioon aadressil yeetform.io/developers) autentitakse API-võtmetega, pakub OpenAPI spetsifikatsiooni, saadab signeeritud HMAC-SHA256 webhooke automaatsete uute katsetega uute vastuste kohta, ning pakub MCP-serverit, et agendid nagu Claude Code, Cursor või ChatGPT saaksid vorme otse luua ja vastuseid lugeda.