REST API de longarm

El servidor HTTP de longarm expone endpoints bajo /api/....

URL base

La app muestra la URL activa cuando el servidor HTTP está iniciado.

http://192.168.1.23:8080

Autenticación

Si Require token está activado, envía:

Authorization: Bearer <token>

Si el token falta o no es válido, longarm devuelve:

{ "error": "Missing or invalid bearer token" }

Comportamiento común

Los cuerpos de POST y PUT deben ser JSON.
El tamaño máximo del cuerpo es 64 KiB.
Las capturas usan image/png.
Las exportaciones por lotes usan application/zip.
CORS está habilitado.

Estado e información de pantalla

GET /api/status
GET /api/screen/info

Ejemplo de información de pantalla:

{ "width": 1080, "height": 2400, "density": 3.0 }

Gestos

`POST /api/gesture/tap`

{ "x": 540, "y": 1200, "duration": 50 }

`POST /api/gesture/long_press`

{ "x": 540, "y": 1200, "duration": 1000 }

Gestos Plus:

POST /api/gesture/swipe
POST /api/gesture/pinch
POST /api/gesture/two_finger_swipe
POST /api/gesture/rotate

Cuando la inspección de UI está habilitada, algunos gestos pueden usar target en lugar de coordenadas directas.

Captura de pantalla

`GET /api/screenshot`

Devuelve bytes PNG.

curl -H "Authorization: Bearer <token>" \
  http://<host>:<port>/api/screenshot > screenshot.png

También admite opciones de cuadrícula como gridSize, gridColor, gridWidth, coordinates y scale.

Apps e intents

`POST /api/app/open`

{ "packageName": "com.android.settings" }

`POST /api/intent/open`

{
  "action": "android.intent.action.VIEW",
  "data": "https://example.com"
}

Inspección de UI

Estas rutas requieren autenticación por bearer token e Allow UI inspection:

GET /api/ui/tree
GET /api/ui/windows
POST /api/ui/find
POST /api/ui/wait
POST /api/ui/action
POST /api/ui/set_text
POST /api/ui/scroll

Rutas de tareas por lotes

Las tareas por lotes usan rutas bajo /api/batch, incluyendo creación, actualización, ejecución, estado, historial, exportación y descarga de capturas.

Consulta Tareas por lotes para el JSON de tareas y el comportamiento de ejecución.