Overview
In addition to our iFrame and HTML snippet publishing methods, you can embed your FormAssembly form on your website using our REST API. This publishing method requires a basic understanding of programming for the web and may not work with all server environments. Our Support team is also not able to assist with writing or editing custom code. Embedded forms require that your site is secured with TLS 1.2 or greater.
If you are using the reCAPTCHA or save & resume features on your form, this is the recommended option for embedding your forms.
Set Up
Using a website editor, copy & paste the following code sample for your code in the web page where you want your form to be visible. When doing this, make sure that you are editing the HTML code directly (often called "HTML view" or "code view").
Your form URL is shown on the Publish page, under the REST API section. Change the URL in the code sample below to match your form's URL. Only the last part (INSERT_FORM_ID_HERE) should be different. If you are an Enterprise Cloud or Compliance Cloud customer, replace app.formassembly.com in the examples below with your FormAssembly instance url.
Servers running PHP
<?php //Set stream options $context = stream_context_create(array('http' => array('ignore_errors' => true))); if(!isset($_GET['tfa_next'])) { $qs = ' '; if(isset($_SERVER['QUERY_STRING']) && !empty($_SERVER['QUERY_STRING'])){$qs='?'.$_SERVER['QUERY_STRING'];}; echo file_get_contents('https://app.formassembly.com/rest/forms/view/INSERT_FORM_ID_HERE'.$qs); } else { echo file_get_contents('https://app.formassembly.com/rest'.$_GET['tfa_next'],false,$context); } ?>
Servers running ASP
<% Dim objWinHttp Dim strHTML Set objWinHttp = Server.CreateObject('WinHttp.WinHttpRequest.5.1') if(request.querystring('tfa_next')='') then objWinHttp.Open 'GET', 'https://app.formassembly.com/rest/forms/view/INSERT_FORM_ID_HERE' else objWinHttp.Open 'GET', 'https://app.formassembly.com/rest' & request.querystring('tfa_next') end if objWinHttp.Send Response.Write objWinHttp.ResponseText Set objWinHttp = Nothing %>
Servers running IIS/.NET
<%@ Import Namespace='System'%> <%@ Import Namespace='System.IO' %> <%@ Import Namespace='System.Net' %> <%@ Import Namespace='System.Text' %> <html> <script language='C#' runat='server'> void Page_Load(Object Src, EventArgs E) { WebRequest request; if (Request.QueryString['tfa_next'] == null) { request = WebRequest.Create('https://app.formassembly.com/rest/forms/view/INSERT_FORM_ID_HERE'); } else { request = WebRequest.Create('https://app.formassembly.com/rest' + Request.QueryString['tfa_next']); } WebResponse response = request.GetResponse (); Stream dataStream = response.GetResponseStream (); StreamReader reader = new StreamReader (dataStream, Encoding.UTF8); FAForm.InnerHtml = reader.ReadToEnd (); reader.Close (); response.Close (); } </script> <body> <span id='FAForm' runat='server'/> </body> </html>
Servers running Ruby on Rails
In your controller:
def feedback if params[:tfa_next] url = "/rest/#{params[:tfa_next]}" else url = '/rest/forms/view/INSERT_FORM_ID_HERE' end response = Net::HTTP.get_response(URI('https://app.formassembly.com'+url)) @form_head, @form_body = response.split('<!-- FORM: BODY SECTION -->') end
In your view:
<% content_for('head') do %> <%= @form_head %> <% end %> <%= @form_body %> In your layout: <head> [...] <%= yield :head %> </head>
Servers running Java
Download Package | com.formassembly.api.rest |
---|
JSP Example
<%@ page language='java' contentType='text/html; charset=UTF-8' pageEncoding='UTF-8'%> <%@ page import='com.formassembly.api.rest.Form' %> <!DOCTYPE html PUBLIC '-//W3C//DTD HTML 4.01 Transitional//EN' 'https://www.w3.org/TR/html4/loose.dtd'> <html> <head> <meta http-equiv='Content-Type' content='text/html; charset=UTF-8'> <title>FormAssembly REST API JAVA Example</title> </head> <body> <%=Form.getHTML(INSERT_FORM_ID_HERE, request.getParameter('tfa_next') )%> </body> </html>
Servers running a different server-side technology
Regardless of what technology is available, if your server is capable of doing HTTP requests, you should be able to retrieve and display the form. Please refer to your server documentation or Google for more information.