Qmapi Developer Documentation

const crypto = require('crypto');
const axios = require('axios');

// Your API credentials
const API_KEY = 'your_api_key';
const HASH_KEY = 'your_hash_key';

// Function to generate authentication token
function generateToken(supplyID, pnid, sessionID) {
  const dataToHash = `${supplyID}${pnid}${sessionID}${HASH_KEY}`;
  const hash = crypto.createHash('sha256')
    .update(dataToHash)
    .digest('base64');
    
  // URL encode the hash
  return hash.replace(/\+/g, '%2B')
    .replace(/\//g, '%2F')
    .replace(/=/g, '%3D');
}

// Function to get available surveys
async function getSurveys(country = 'US', limit = 50) {
  try {
    const response = await axios.get(
      `https://api.qmapi.com/api/v2/survey?country=${country}&limit=${limit}`,
      {
        headers: {
          'Authorization': `Bearer ${API_KEY}`,
          'Content-Type': 'application/json'
        }
      }
    );
    return response.data;
  } catch (error) {
    console.error('Error fetching surveys:', error);
    return null;
  }
}

// Usage example
(async () => {
  const surveys = await getSurveys();
  console.log(surveys);
  
  // Generate survey link with token
  if (surveys && surveys.length > 0) {
    const survey = surveys[0];
    const supplyID = '0101';
    const pnid = '855e5b07-d293-45c8-ac38-173307446c18';
    const sessionID = `session-${Date.now()}`;
    const token = generateToken(supplyID, pnid, sessionID);
    
    // Build the final URL
    const surveyUrl = `${survey.livelink.replace('[%SupplyID%]', supplyID)
      .replace('[%AID%]', pnid)
      .replace('[%sessionID%]', sessionID)
      .replace('[%TokenID%]', token)}`;
      
    console.log('Survey URL:', surveyUrl);
  }
})();

import requests
import hashlib
import base64
import urllib.parse
import json

# Your API credentials
API_KEY = "your_api_key"
HASH_KEY = "your_hash_key"

# Function to generate authentication token
def generate_token(supply_id, pnid, session_id):
    data_to_hash = f"{supply_id}{pnid}{session_id}{HASH_KEY}"
    hash_bytes = hashlib.sha256(data_to_hash.encode()).digest()
    hash_b64 = base64.b64encode(hash_bytes).decode()
    
    # URL encode the hash
    return hash_b64.replace('+', '%2B').replace('/', '%2F').replace('=', '%3D')

# Function to get available surveys
def get_surveys(country='US', limit=50):
    try:
        response = requests.get(
            f"https://api.qmapi.com/api/v2/survey?country={country}&limit={limit}",
            headers={
                "Authorization": f"Bearer {API_KEY}",
                "Content-Type": "application/json"
            }
        )
        return response.json()
    except Exception as e:
        print(f"Error fetching surveys: {e}")
        return None

# Function to build survey URL with qualification data
def build_survey_url(survey, supply_id, pnid, session_id, qualifications=None):
    token = generate_token(supply_id, pnid, session_id)
    
    # Start with base URL
    url = survey["livelink"]
    url = url.replace('[%SupplyID%]', supply_id)
    url = url.replace('[%AID%]', pnid)
    url = url.replace('[%sessionID%]', session_id)
    url = url.replace('[%TokenID%]', token)
    
    # Add qualification data if provided
    if qualifications:
        url += f"&questions={urllib.parse.quote(json.dumps(qualifications))}"
    
    return url

# Usage example
if __name__ == "__main__":
    surveys = get_surveys()
    
    if surveys and len(surveys) > 0:
        survey = surveys[0]
        supply_id = "0101"
        pnid = "855e5b07-d293-45c8-ac38-173307446c18"
        session_id = "a4ab1638-4540-4933-bcla-5bb81bb68afc"
        
        # Example qualification data
        qualifications = [
            {"Question_ID": 21, "value": 23},
            {"Question_ID": 22, "value": 1}
        ]
        
        survey_url = build_survey_url(survey, supply_id, pnid, session_id, qualifications)
        print(f"Survey URL: {survey_url}")