Skip to main content

Documentation Index

Fetch the complete documentation index at: https://apidocs.salamoonder.com/llms.txt

Use this file to discover all available pages before exploring further.

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

PropertyTypeRequired
access_tokenStringYes
device_idStringNo
client_idStringNo

​
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)