Website

API

Generic selectors
Exact matches only
Search in title
Search in content
Post Type Selectors

Docy

This section contains information to help you start using the API.

What is an API?

An API (application programming interface) is a way for different pieces of software to talk to each other via the Internet, using standardised communication protocols. Applications (‘clients’) which consume APIs may be authored in any of the many available programming languages.

What is Visit Create API?

Visit Create API exposes core Visit Create data to enable communication with external software components. Endpoints are available which expose information in both XML and JSON formats, they are interchangeable interfaces to the same underlying database.

What is the API used for?

The goal of the API is to facilitate automated communication between third party systems or software and the Visit Create database. It focuses on creating, reading, updating, and deleting visitor and partner information.

Common uses of Visit Create API include:

  • Extracting registration data for use in third party applications, such as data warehouses, housing/booking systems, dynamic websites and accounting systems.
  • Automated management of visitors’ registration details, to enable either partial (‘invited’ registrants) or complete registrations from a third-party system.
  • Replication of visitor registration details from Visit Create into a third-party system
  • Automated creation and management of exhibitor details and accounts in Visit Create
  • Replication of exhibitor details from Visit Create into a third-party system

How to use the API?

In order to use the API you need to authorize all software calls with an authorization key. Keys are managed by admin users from Organisations who have the user account management role.

API Keys

Access from homepage: Organisation > API > API keys

Add an API key

  1. Select + Add
  2. Enter the API Key state: Active/Disabled
  3. Describe in the Comments field what it is used for
  4. Optional:

  • Specify when it expires in the Expires after field
  • Limit its use to specific location from Allowed IP Addresses
  • Select the events you want to enable it for in Events
  • Add the contact details of the person in charge of it

Advanced

The Advanced tab refers to the Advanced API which is a programming environment that enables the users to build integrations directly within the Visit Create interface. It can be used as an alternative to ‘middleware’, therefore removing the need for hosting a software application elsewhere. Code is written in JavaScript, making calls to both Visit’s API and those belonging to other software services. For ease of programming, code which accesses Visit’s JSON API is recommended over the XML version.

The Advanced API supports the following two integration types:

Background task

A background task is a scheduled task which runs periodically in Visit Create. The call frequency is approximately every 9 minutes. This function would typically be used to automate the process of reading/writing data between Visit Create and an external process. The flow of information may be from Visit Create to the external system, from the external system to Visit Create or a combination of the two. For example, you might implement a background task which checks for new registrations in Visit Create and updates an external CRM system.

Endpoint function

Adding an endpoint function generates an associated URL which enables it to be triggered by and external call. When creating the function, you will be prompted to supply a valid API key which is associated with it. In a similar way to background tasks, you are free to work with Visit’s API and external systems to meet the requirements of your integration. An example is where you wish to synchronise external registrations with data; the action of creating record calls the Endpoint. The endpoint function in this case contains the necessary logic to fetch the new data from the remote system and create the new record in Visit Create using our JSON API.

Add function

  1. Select + Add
  2. Enter a Name
  3. Select a function from the dropdown list available
    • You should provide a unique key to identify your function if you select Endpoint
  4. Select Save

Statistics

The Statistics tab shows you the number of API calls as per your set filters: type, from, until and resolution.

CONTENTS