API documentation

Overview

When you tap Upload on a photo, Arguox sends one POST request to the HTTPS URL you set. The body is application/json and holds the action type, every metadata field you have turned on, and the image as Base64.

There's no Arguox API key, account or server in between. You provide the endpoint and the app posts to it directly.

Setup

Button modes

Endpoint

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

Your endpoint needs to accept a POST request with a JSON body. Arguox doesn't add any custom headers besides Content-Type.

Payload fields

The payload only includes fields you have turned on in Settings. Fields that are dropped when you're offline are marked below.

Core (always present)

Time Toggle in Settings

Location Toggle in Settings Omitted offline

Device Info Toggle in Settings

Camera and manual details

Environmental Toggle under Environmental in Settings All off by default

Each field has its own toggle. Anything you leave off is missing from both the overlay and the payload. Altitude comes from the GPS fix and works offline. Elevation, weather and humidity come from the Open-Meteo API, as does pressure on Android, so they're left out when there's no connection.

Full example

A payload from the IN button in Dual mode, with Date & Time, Location and Device Info turned on:

{
  "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"
}

Offline, the location fields are left out. The time, device info and manual details are still sent if you have them turned on.

Offline and the upload queue

Taking photos and saving them to the gallery don't depend on a connection. The free version does need internet, because it has to load ads. With Remove Ads the app works fully offline.

When the phone is offline at capture time:

• GPS and the street address are left off the overlay and the payload.
• The time comes from the phone's clock, same as when online.
• If you tap Upload, the request waits in a queue on the phone.

When the connection comes back, queued uploads go out on their own. The QUEUE pill on the camera shows how many are pending or failed.

Timestamps

Arguox stamps each capture with the phone's own clock. It doesn't check the time against a server, so the shutter never waits on the network. If the phone's clock is wrong, the timestamp will be wrong too.

That time goes straight into the timestamp field in the payload.

Error handling

Any HTTP 2xx response counts as a success. Any other status, 3xx redirects included, counts as a failure and goes back in the queue for a retry.

How retries work

• Queued uploads retry on their own when the connection comes back.
• You can retry a single item from the queue.
• "Retry Failed" retries every failed item at once.
• Each item keeps its retry count and last retry time on the phone.

Recommended server response

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

{ "status": "ok" }

Google Sheets & Drive

You can use a free Google Apps Script web app as your endpoint. Each upload saves the photo to your Google Drive and adds a row to a Google Sheet. You don't need a server or hosting, and it costs nothing.

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