API Documentation

Overview

Arguox sends a single POST request to a user-configured HTTPS URL every time a photo is captured. The request body is application/json and includes all enabled metadata fields, the action type, and the captured image encoded as Base64.

There is no Arguox API key, account, or server involved. You supply the endpoint; Arguox delivers the payload.

Setup

Button Modes

Endpoint

POST {your-configured-url}
Content-Type: application/json

Your endpoint must accept a POST request with a JSON body. No special headers are added by Arguox beyond Content-Type.

Payload Fields

Only fields that are enabled in Settings appear in the payload. Fields omitted when offline are noted below.

Core (always present)

Time Toggle in Settings

Location Toggle in Settings Omitted offline

Device Info Toggle in Settings

Camera & Manual

Environmental Toggle in Settings → Environmental All off by default

Each field is toggled independently. Fields not enabled are omitted from both the overlay and the payload. Weather and humidity require an internet connection (Open-Meteo API); altitude is GPS-derived and works offline.

Full Example

Complete payload — all fields enabled, Dual mode, IN action:

{
  "action":        "IN",
  "timestamp":     "2026-05-14T10:30:00Z",
  "date":          "2026-05-14",
  "time":          "10:30:00 AM",
  "timezone":      "Etc/UTC",
  "unixTimestamp": 1747218600,
  "latitude":      "37.7749",
  "longitude":     "-122.4194",
  "street":        "Main Street",
  "barangay":      "Sample District",
  "city":          "Sample City",
  "province":      "Sample Region",
  "country":       "Sample Country",
  "countryCode":   "--",
  "postalCode":    "00000",
  "deviceName":    "Samsung Galaxy S24",
  "deviceBrand":   "Samsung",
  "deviceModel":   "SM-S921B",
  "osVersion":     "Android 15",
  "cameraType":    "rear",
  "flashStatus":   "off",
  "manualDetails": ["Job #1042", "Supervisor: Juan Lobby"],
  "imageBase64":   "BASE64_ENCODED_JPEG_DATA",
  "imageFileName": "IMG_20260514_103007.jpg"
}

Minimal payload (Single mode, offline)

{
  "action":        "CAPTURE",
  "timestamp":     "2026-05-14T10:30:00Z",
  "date":          "2026-05-14",
  "time":          "10:30:00 AM",
  "timezone":      "Etc/UTC",
  "unixTimestamp": 1747218600,
  "manualDetails": [],
  "imageBase64":   "BASE64_ENCODED_JPEG_DATA",
  "imageFileName": "IMG_20260514_103007.jpg"
}

When offline, location fields are omitted entirely. Timestamp, device info, and manual details are still present.

Offline & Upload Queue

Photo capture and local gallery save always succeed regardless of connectivity. The free ad-supported tier still requires internet to serve ads — Remove Ads unlocks full offline use.

When the device is offline at capture time:

• GPS and reverse-geocoded address are omitted from overlay and payload.
• Device clock is used for the timestamp (same as when online).
• The API POST is queued on your device.

When internet reconnects, queued uploads retry automatically. The QUEUE pill shows pending + failed count.

Timestamps

Arguox uses the device's own clock to timestamp each capture — there's no external time-verification API and no drift check, so the shutter never waits on a network round-trip.

The device time is written directly to the timestamp value in the payload.

Error Handling

Arguox considers any HTTP 2xx response a success. Any other status code (including 3xx redirects) is treated as a failure and queued for retry.

Retry behavior

• Automatic retry when internet reconnects.
• Manual per-item retry via the Queue modal.
• Batch retry via "Retry Failed" button.
• Retry count and last retry timestamp stored per item on your device.

Recommended server response

HTTP/1.1 200 OK
Content-Type: application/json

{ "status": "ok" }

Google Sheets & Drive

Use a free Google Apps Script web app as your endpoint. Every capture will save the photo to your Google Drive and log a row in your Google Sheet — no server, no hosting, no cost.

Apps Script code

function doPost(e) {
  try {
    var data = JSON.parse(e.postData.contents);

    // 1. Save photo to Google Drive
    var driveLink = "";
    if (data.imageBase64 && data.imageFileName) {
      var folder = getOrCreateFolder("Arguox Captures");
      var bytes  = Utilities.base64Decode(data.imageBase64);
      var blob   = Utilities.newBlob(bytes, "image/jpeg", data.imageFileName);
      var file   = folder.createFile(blob);
      file.setSharing(DriveApp.Access.ANYONE_WITH_LINK, DriveApp.Permission.VIEW);
      driveLink  = file.getUrl();
    }

    // 2. Log row to Google Sheets
    var sheet = getOrCreateSheet("Arguox Logs");
    sheet.appendRow([
      data.date          || "",
      data.time          || "",
      data.action        || "",
      data.latitude      || "",
      data.longitude     || "",
      [data.street, data.city, data.country].filter(Boolean).join(", "),
      [data.deviceBrand, data.deviceModel].filter(Boolean).join(" "),
      data.imageFileName || "",
      driveLink,
      new Date().toISOString(),
    ]);

    return ContentService
      .createTextOutput(JSON.stringify({ status: "ok", driveLink: driveLink }))
      .setMimeType(ContentService.MimeType.JSON);

  } catch (err) {
    return ContentService
      .createTextOutput(JSON.stringify({ status: "error", message: err.message }))
      .setMimeType(ContentService.MimeType.JSON);
  }
}

// ── helpers ──────────────────────────────────────────────────────────────────

function getOrCreateFolder(name) {
  var folders = DriveApp.getFoldersByName(name);
  return folders.hasNext() ? folders.next() : DriveApp.createFolder(name);
}

function getOrCreateSheet(name) {
  var files = DriveApp.getFilesByName(name);
  var ss;
  if (files.hasNext()) {
    ss = SpreadsheetApp.open(files.next());
  } else {
    ss = SpreadsheetApp.create(name);
    var sheet = ss.getActiveSheet();
    sheet.setName("Logs");
    sheet.appendRow([
      "Date", "Time", "Action",
      "Latitude", "Longitude", "Address",
      "Device", "Filename", "Drive Link", "Received At"
    ]);
    sheet.setFrozenRows(1);
  }
  return ss.getActiveSheet();
}

What you get