Colide API Gateway

POST /api/colide_api_gateway-v1.0/
  ?token=YOUR_API_KEY          # required (or active session cookie)
  &session_id=123            # optional — load conversation history
  &agent_mode=on             # optional — activate agent mode
  &server_name=my-server     # required when agent_mode=on

# POST body — multipart/form-data or x-www-form-urlencoded
message=Your message here
image_content=[optional file upload or raw binary]

{
  "success":       true,
  "session_id":    42,
  "session_name":  "MyChat",
  "session_owner": "sk-abc123…",  // API key or gosyntech_id
  "created_at":    "2025-01-01 12:00:00"
}

curl -X POST \
  "https://shulker.in/api/colide_api_gateway-v1.0/
  ?agent_mode=on&server_name=my-server" \
  --cookie "PHPSESSID=your_session_id" \
  -F "message=My server is lagging. Check the logs and fix it."

data: {"token": "Hello"}

data: {"token": " world"}

data: {"token": "!"}

data: {
  "done": true,
  "usage": {
    "input_words": 12,
    "output_words": 84,
    "total_words": 96
  },
  // agent_mode only fields:
  "agent_mode": true,
  "is_devspace": false,
  "server": { "name": "my-server", "node": "node-us", ... },
  "detected_actions": ["stop_server", "restart_server"],
  "needs_file_callback": false,
  "file_contents": []
}

data: {"error": "Colide API service unavailable"}

const formData = new FormData();
formData.append('message', 'Hello Colide!');

const response = await fetch(
  'https://shulker.in/api/colide_api_gateway-v1.0/?token=YOUR_API_KEY',
  { method: 'POST', body: formData }
);

const reader = response.body.getReader();
const decoder = new TextDecoder();
let fullText = '';

while (true) {
  const { done, value } = await reader.read();
  if (done) break;
  const chunk = decoder.decode(value);
  for (const line of chunk.split('\n')) {
    if (!line.startsWith('data: ')) continue;
    const ev = JSON.parse(line.slice(6));
    if (ev.token) { fullText += ev.token; /* update UI */ }
    if (ev.done)  console.log('Done!', ev.usage, ev.detected_actions);
    if (ev.error) console.error('Error:', ev.error);
  }
}

curl -X POST \
  "https://shulker.in/api/colide_api_gateway-v1.0/
  ?agent_mode=on&server_name=my-server&session_id=101" \
  --cookie "PHPSESSID=your_session_id" \
  -F "file_data_callback=true" \
  -F 'file_contents=[{"file_path":"/plugins/P/config.yml",
   "content":"enabled: true\n...","lines":42}]'

[
  {
    "file_path": "/plugins/MyPlugin/config.yml",
    "content":   "full file text here...",
    "lines":     42
  }
]

{ "error": "Human-readable message" }

const formData = new FormData();
formData.append('message', 'What is Shulker?');

const res = await fetch(
  'https://shulker.in/api/colide_api_gateway-v1.0/?token=YOUR_API_KEY&session_id=1',
  { method: 'POST', body: formData }
);

const reader = res.body.getReader();
const decoder = new TextDecoder();
let output = '';

while (true) {
  const { done, value } = await reader.read();
  if (done) break;
  for (const line of decoder.decode(value).split('\n')) {
    if (!line.startsWith('data: ')) continue;
    const ev = JSON.parse(line.slice(6));
    if (ev.token) { output += ev.token; process.stdout.write(ev.token); }
    if (ev.done)  console.log('\nDone', ev.usage);
    if (ev.error) console.error(ev.error);
  }
}

import requests, json

url    = "https://shulker.in/api/colide_api_gateway-v1.0/"
params = {"token": "YOUR_API_KEY", "session_id": 1}

with requests.post(url, params=params,
                     data={"message": "What is Shulker?"},
                     stream=True) as r:
    for raw_line in r.iter_lines():
        if not raw_line: continue
        line = raw_line.decode()
        if not line.startswith("data: "): continue
        ev = json.loads(line[6:])
        if "token" in ev:
            print(ev["token"], end="", flush=True)
        if ev.get("done"):
            print("\nDone!", ev["usage"])
        if "error" in ev:
            print("Error:", ev["error"])

import requests, json

with open("screenshot.png", "rb") as f:
    r = requests.post(
        "https://shulker.in/api/colide_api_gateway-v1.0/",
        params={"token": "YOUR_API_KEY"},
        data={"message": "What does this error mean?"},
        files={"image_content": ("screenshot.png", f, "image/png")},
        stream=True
    )
    for raw in r.iter_lines():
        if raw and raw.decode().startswith("data: "):
            ev = json.loads(raw.decode()[6:])
            if "token" in ev: print(ev["token"], end="", flush=True)

$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL            => "https://shulker.in/api/colide_api_gateway-v1.0/?token=YOUR_API_KEY",
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => ["message" => "What is Shulker?"],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_WRITEFUNCTION  => function($ch, $chunk) {
        foreach (explode("\n", $chunk) as $line) {
            if (str_starts_with($line, "data: ")) {
                $ev = json_decode(substr($line, 6), true);
                if (isset($ev['token'])) echo $ev['token'];
            }
        }
        return strlen($chunk);
    }
]);
curl_exec($ch);
curl_close($ch);