Supplier API Documentation

For supplier app integration with Tarabot middleware.

Developer: IXCHEL CORPORATION (M) SDN BHD | Version: v1 | Creation Date: 2026-03-16

Base

https://api.tarabot.com.my/v1/api (recommended) or /api.php

Headers: X-API-Key, optional X-API-Version: v1

Actions

Action	Purpose
`handshake`	Connectivity/auth check
`get_robot_status`	Read current status
`start_session`	Start massage
`pause_session`	Pause session
`stop_session`	Stop session
`report_completion`	Report completed/collision
`push_treatment_plan`	Send treatment plan selection (Tarabot side)
`pull_treatment_plan`	Fetch queued plan
`ack_treatment_plan`	Acknowledge plan status

Handshake

{ "action": "handshake", "nonce": "abc-123" }

Send Treatment Plan Selection (Tarabot -> Middleware)

Auth: X-Internal-Key: <INTERNAL_API_KEY>

{
  "action": "push_treatment_plan",
  "robot_id": "TRB001",
  "session_id": "SES20260317143000",
  "head_type": "H1",
  "technique_code": 2,
  "duration_min": 20,
  "intensity": "default",
  "plan": {
    "selection": "Shoulder + Back",
    "notes": "Start with fascia focus"
  }
}

Pull Treatment Plan

{ "action": "pull_treatment_plan", "robot_id": "TRB001", "supplier_id": "supplier-app-1" }

Ack Treatment Plan

{ "action": "ack_treatment_plan", "plan_id": "TPL202603171200009999", "ack_status": "accepted", "note": "Job received" }

Status tags: accepted running completed failed rejected

Supplier-facing documentation page.