Acutus AI - Link Integration Guide

Overview

Welcome to the Acutus AI Link Integration Guide. This document provides all the necessary information for suppliers to integrate with our API endpoint for survey routing.

API Endpoint

https://api.qmapi.com/router/acutus?supplyID=[%SupplyID%]&country=[%country%]&cpi=1&PNID=[%PNID%]&SessionID=[%SID%]

Parameter Details

Required Parameters

Parameter	Description	Example	Notes
supplyID	Unique supplier identifier	[%SupplyID%]	Provided by Acutus AI
country	Country code for targeting	eng_in	See country codes table below
cpi	Cost per interview (fixed)	1	Provided by Acutus AI
PNID	Respondent/User ID	[%PNID%]	Replace with your user ID
SessionID	Session identifier	[%SID%]	Additional tracking parameter

Supported Countries & Codes

Country	Country Code	Language
India	eng_in	English
United States	eng_us	English
Australia	eng_au	English
Singapore	eng_sg	English
Egypt	ara_eg	Arabic
United Arab Emirates	ara_ae	Arabic
Saudi Arabia	ara_sa	Arabic
Malaysia	may_my	Malay
Qatar	ara_qa	Arabic

Integration Steps

1Get Your Supply ID

Contact Acutus AI to obtain your unique supplyID. This identifier will be used for all your survey routing requests.

2Build Your Integration URL

Replace the placeholder values in the base URL:

                    https://api.qmapi.com/router/acutus?supplyID=YOUR_SUPPLY_ID&country=COUNTRY_CODE&cpi=1&PNID=USER_ID&SessionID=SESSION_ID
                

3Implementation Example

For a user from India:

                    https://api.qmapi.com/router/acutus?supplyID=12345&country=eng_in&cpi=1&PNID=respondent123&SessionID=session456
                

For a user from United States:

                    https://api.qmapi.com/router/acutus?supplyID=12345&country=eng_us&cpi=1&PNID=respondent123&SessionID=session456
                

Parameter Mapping Guide

Dynamic Parameters You Need to Replace:

1. [%SupplyID%] → Your unique supplier ID (provided by Acutus AI)

2. [%country%] → Appropriate country code from the table above

3. [%PNID%] → Your respondent/user identifier

4. [%SID%] → Your session tracking ID

5. cpi Provided By acutusAI

Best Practices

URL Construction

• Ensure all parameters are properly URL-encoded

• Validate country codes before sending requests

• Use meaningful respondent IDs for better tracking

Error Handling

• Implement proper error handling for invalid country codes

• Monitor response codes for successful routing

• Log failed requests for debugging

Security

• Keep your supplyID confidential

• Use HTTPS for all requests

• Validate user data before including in URLs

Sample Implementation Code

JavaScript Example

                    function buildAcutusURL(supplyID, country, respondentID, sessionID) {
                    const baseURL = 'https://api.qmapi.com/router/acutus';
                    const params = new URLSearchParams({
                    supplyID: supplyID,
                    country: country,
                    cpi: '1',
                    PNID: respondentID,
                    SessionID: sessionID
                    });

                    return `${baseURL}?${params.toString()}`;
                    }

                    // Usage
                    const url = buildAcutusURL('12345', 'eng_us', 'user123', 'session456');
                

PHP Example

                    function buildAcutusURL($supplyID, $country, $respondentID, $sessionID) {
                    $baseURL = 'https://api.qmapi.com/router/acutus';
                    $params = http_build_query([
                    'supplyID' => $supplyID,
                    'country' => $country,
                    'cpi' => '1',
                    'PNID' => $respondentID,
                    'SessionID' => $sessionID
                    ]);

                    return $baseURL . '?' . $params;
                    }

                    // Usage
                    $url = buildAcutusURL('12345', 'eng_us', 'user123', 'session456');
                