September 12, 2023 | 7 min read

What Is an API?

An API, or Application Programming Interface, is a set of rules that define how two software applications can interact with each other. It is a way for different programs to communicate and share data without having to know anything about each other's internal workings.

An API is often described as a bridge between different software applications. This is because it allows the applications to communicate with each other even if they are written in different programming languages or use different platforms.

Events APIs

Event APIs

Event APIs are powerful tools that can help event organizers streamline their workflows and improve the overall experience for attendees. They can be used to transfer data between different systems, display real-time information on mobile apps, and automate financial tasks.

For example, event APIs can be used to:

Event APIs are a valuable tool for any event organizer who wants to improve the efficiency and effectiveness of their event management process.

Here are some additional benefits of using event APIs:

Eventact APIs: Key Features

Comprehensive Event Data

Gain access to a wealth of event information, including event lists, presentation topics, presenter details, abstracts, visitor insights, and much more.

Integration Possibilities

Eventact's APIs are designed exclusively for our customers who organize events through our platform. While they are not publicly accessible, they provide powerful tools for enhancing the event management process.

With Eventact's APIs, our customers can:

Enhance Their Websites:
Integrate real-time event data and tools, such as registration forms, directly into their websites, regardless of the website's platform or programming language.
Generate Reports:
Create internal reports and analytics, such as attendance reports, speaker evaluations, and financial reports. Make visualizations of the event data, such as charts and graphs, to inform decision-making.
Fuel Content Creation:
Use event data to craft articles and social media posts.

Accessing Eventact APIs: Obtaining a Token

To access information from the Eventact APIs, the first step is obtaining a token. Here's a step-by-step guide on how to obtain your token:

Step 1: Prepare Your Credentials

Before you can request a token, ensure you have the following credentials ready (you will obtain them from Eventact):

Step 2: Make a POST Request

Now you can make a POST request to the Eventact API at this endpoint: https://api.eventact.com/api-v1/office/login/login, and include a JSON object like this:

{
   username: 'anna',
   password: '12345',
   companyname: 'company'
}

that has been "stringified" in the request body.

Here's an example of how you might define such a function in React:

function GetToken() {
    const fetchData = async () => {
        try {
            const requestData = {
                username: 'anna',
                password: '12345',
                companyname: 'New_company',
            };

            const response = await fetch('https://api.eventact.com/api-v1/office/login/login', {
                method: 'POST',
                headers: {
                'Content-Type': 'application/json',
                },
                body: JSON.stringify(requestData),
            });

            if (response.ok) {
                const data = await response.json();
            } else {
                console.error('Error fetching data');
            }
        } catch (error) {
            console.error('Error:', error);
        }
    };

    fetchData();
}

The response data will have the following structure:

{  
 "companyName": "New_company",
 "companyID": 555, 
 "key": "XdMZdjiEh10jsyFzS6uYRtDhJogYkqkSydJA", 
}

The "key" field in the response represents the token, which you can use for further requests. You can define it in your code as follows:

Let token=data.key

Step 3: Access Eventact's API for Event Information

Eventact offers a variety of APIs tailored to meet your specific requirements. To gain access to the complete list of available APIs and their detailed documentation, simply reach out to us with your request.

You will be able to retrieve data by changing the IDs of agenda, hall, event or other in the API endpoint according to the documentation. Additionally, you can add query parameters after the "?" mark at the end of the endpoint in the format like ?fromDate={timestamp} to filter and customize the data you receive.

To accomplish this, you will need to make an HTTP GET request to the relevant Eventact API endpoint, which will resemble the following URL structure: "https://api.eventact.com/api-v1/agenda/${projectID}/agendas/list".

Here, replace projectID with the numeric identifier of the specific event you are interested in. Additionally, ensure that you include the required headers in your request, as demonstrated below:

headers: {
    'API-token': token
    }  

For your convenience, we provide a sample function named GetAgendasList that encapsulates this API request:

function GetAgendasList(projectID, token) {
    const apiUrl = `https://api.eventact.com/api-v1/agenda/${projectID}/agendas/list`;

    return fetch(apiUrl, {
        method: 'GET',
        headers: {
            'API-token': token,
        },
    })
        .then((response) => {
            if (!response.ok) {
                throw new Error('Network response was not ok');
            }
            return response.json();
    })
        .then((data) => {
            return data;
    })
        .catch((error) => {
            console.error('Fetch error:', error);
            throw error;
        });
}

The data you receive from this API request will be an array of objects, each representing an agenda item for the event. These objects will include details such as the agenda name, type, duration, start and end times, language, and other relevant information.

Once you obtain this data, you can seamlessly integrate it into your website or application to create a table or display event-related information as needed.

Conclusion

APIs can be a powerful tool for event organizers who want to manage their events or data. They offer a number of advantages, including:

If you are an event organizer who is looking for a way to improve the efficiency and scalability of your event management, we encourage you to learn more about event APIs. There are many different APIs available, so you can find one that meets your specific needs.

To learn more about Eventact APIs, please visit our website or contact us for a demo. We would be happy to help you get started.

Read more