Use a Server-Side Script (REST API) 


In this Article
Related Articles

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
Note: For Enterprise Cloud and Compliance Cloud customers, Java 1.6.0 is not supported.

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.

We'd love to expand this section. If you have a working method not documented here, please email it to us at support@formassembly.com. Thank you!
Terms of Service · Privacy Policy