Integrity

This helper task creates an Integrity token for Twitch actions like following, subscribing, or sending bits. You can also do this with our Kasada task, this just makes it easier.

Create Task

Create the task with the createTask endpoint, or use our Software Development Kit to make your integration process even easier!

Task Structure

Property	Type	Required
`access_token`	String	Yes
`device_id`	String	No
`client_id`	String	No

Example Request

POST https://salamoonder.com/api/createTask
Host: salamoonder.com
Content-Type: application/json

{
    "api_key": "YOUR_API_KEY",
    "task": {
        "type": "Twitch_PublicIntegrity",
        "access_token": "your_twitch_account_oauth",
        //"device_id": "K3sKKpQhYQwymZFP6zIcu5LCOxyT24",
		//"client_id": "kimne78kx3ncx6brgo4mv6wki5h1ko"
    }
}

Upon successfully submitting the task to us, you should receive a ‘taskId’ in the response.

Example Response

{
  "error_code": 0,
  "error_description": "",
  "taskId": "d4611a5f-9b4e-4f4a-94a2-8303d97562e1"
}

Response Fields:

taskId - Unique identifier for this task. Use this to retrieve results.

Getting Results

Retrieve the results using the getTaskResult method. or use our Software Development Kit to make your integration process even easier!

Example Request

POST https://salamoonder.com/api/getTaskResult
Host: salamoonder.com
Content-Type: application/json

{
  "api_key": "YOUR_API_KEY",
  "taskId": "d4611a5f-9b4e-4f4a-94a2-8303d97562e1"
}

Example Response

{
   "errorId":0,
   "solution":{
      "device-id":"ba478854e9d42411....",
      "integrity-token":"v4.local.IvusFCEJ6-Srca31_dOMU6WnJRLFy7P-rH_4..",
      "expiration":"1763692850412",
      "user-agent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleW..",
      "client-id":"kimne78kx3ncx6brgo4mv6wki5h1ko"
   },
   "status":"ready"
}

Response Fields:

device-id - Device identifier used for this task
integrity-token - Ready-to-use Twitch integrity token for authentication
expiration - Whenever the token will expire.
user-agent - User-agent that was used to generate the token
client-id - Client ID used for this request

Quick Start Example

Because this is a helper function, there is no official example available, but we do include quick start code in Python.

import requests
import json
import time

API_KEY = "YOUR_API_KEY"
BASE_URL = "https://salamoonder.com/api"

ACCESS_TOKEN = ""

# Step 1: Create task
task_data = {
    "api_key": API_KEY,
    "task": {
        "type": "Twitch_PublicIntegrity",
        "access_token": ACCESS_TOKEN,
        #"device_id": "your_device_id",
        #"client_id": "your_client_id"
    }
}

response = requests.post(f"{BASE_URL}/createTask", json=task_data)
task_id = response.json()["taskId"]
print(f"Task created: {task_id}")

# Step 2: Poll for results
while True:
    result_data = {
        "api_key": API_KEY,
        "taskId": task_id
    }
    
    response = requests.post(f"{BASE_URL}/getTaskResult", json=result_data)
    result = response.json()
    
    if result["status"] == "ready":
        token = result["solution"]["integrity-token"]
        user_agent = result["solution"]["user-agent"]
        print(f"Integrity Token: {token}")
        print(f"User-Agent: {user_agent}")
        break
    
    time.sleep(2)

Welcome

API

Tasks

Create Task

Task Structure

Example Request

Example Response

Getting Results

Example Request

Example Response

Quick Start Example

​Create Task​

​Task Structure

​Example Request

​Example Response

​Getting Results

​Example Request

​Example Response

​Quick Start Example

Create Task

Task Structure

Example Request

Example Response

Getting Results

Example Request

Example Response

Quick Start Example