LQM Menü API'si

Authorization: Bearer lqm_YOUR_KEY

HTTP/1.1 422 Unprocessable Entity
Content-Type: application/json; charset=utf-8

{ "error": { "code": "validation_error", "message": "is_sold_out: Invalid input: expected boolean, received undefined" } }

GET /branches/8beb7e3e-852c-428c-828b-62658089a800/products?updated_since=2026-10-22T14:30:00Z&limit=100

{
  "data": [
    { "id": "923fb739-…", "…": "…", "updated_at": "2026-10-22T14:30:36Z", "deleted_at": null },
    { "id": "1f3922e8-8018-48e4-bae6-e04a8801991d", "updated_at": "2026-10-22T14:31:15Z", "deleted_at": "2026-10-22T14:31:15Z" }
  ],
  "next_cursor": null
}

{
  "id": "af04129a-aa38-4625-8033-2deecf2fbc39",
  "category_id": "6c118c2d-8693-411e-8885-83b345aa5f6a",
  "sort_order": 0,
  "sku": "BRG-001",
  "translations": {
    "tr": { "name": "Hamburger", "description": "El yapımı köfte", "ingredients": "Dana köfte, brioche ekmek, marul" },
    "en": { "name": "Hamburger", "description": "Handmade patty", "ingredients": "Beef patty, brioche bun, lettuce" },
    "ar": { "…": "…" },
    "ru": { "…": "…" }
  },
  "price": 25000,
  "currency": "TRY",
  "tax_rate": 10,
  "images": [{ "url": "https://ladomapps-media.ladom.co/menu/…/….webp", "is_primary": true }],
  "portion": "220 g",
  "calories": 650,
  "ingredients": ["Dana köfte", "brioche ekmek", "marul"],
  "allergens": ["gluten", "eggs", "milk", "sesame"],
  "allergens_declared": true,
  "contains_alcohol": false,
  "contains_pork": false,
  "option_group_ids": ["og_af04129a-aa38-4625-8033-2deecf2fbc39"],
  "is_active": true,
  "is_sold_out": false,
  "sold_out_source": null,
  "campaign": null,
  "updated_at": "2026-10-22T14:30:47Z",
  "deleted_at": null
}

{
  "id": "og_af04129a-aa38-4625-8033-2deecf2fbc39",
  "product_id": "af04129a-aa38-4625-8033-2deecf2fbc39",
  "translations": { "tr": { "name": "Seçenek" }, "en": { "name": "Option" }, "…": "…" },
  "selection": "single",
  "required": true,
  "min": 1,
  "max": 1,
  "options": [
    { "id": "93e8a968-dd2f-427c-bbc5-80b842874dec", "translations": { "tr": { "name": "Tek köfte" }, "…": "…" },
      "price_delta": 0, "is_default": true, "is_sold_out": false, "sold_out_source": null, "sort_order": 0 },
    { "id": "944b2d3d-1a79-4a85-b817-3f296156a450", "translations": { "tr": { "name": "Çift köfte" }, "…": "…" },
      "price_delta": 9000, "is_default": false, "is_sold_out": true, "sold_out_source": "pos", "sort_order": 1 }
  ],
  "updated_at": "2026-10-22T14:30:47Z",
  "deleted_at": null
}

{
  "id": "17468dea-c551-49e5-9d3c-3e155dada881",
  "translations": { "tr": { "name": "Ekstralar" }, "en": { "name": "Extras" }, "…": "…" },
  "selection": "multiple",
  "required": false,
  "min": 0,
  "max": 3,
  "options": [
    { "id": "5c0b…", "translations": { "tr": { "name": "Ekstra peynir" }, "…": "…" }, "price_delta": 1500,
      "is_default": false, "is_sold_out": false, "sold_out_source": null, "sort_order": 0 },
    { "id": "285d1169-afd9-4330-bf38-39063626d609", "translations": { "tr": { "name": "Bacon" }, "…": "…" }, "price_delta": 3000,
      "is_default": false, "is_sold_out": false, "sold_out_source": null, "sort_order": 1 }
  ],
  "updated_at": "2026-10-22T14:52:10Z",
  "deleted_at": null
}

{
  "id": "8beb7e3e-852c-428c-828b-62658089a800",
  "name": "GG Burger",
  "currency": "TRY",
  "default_language": "tr",
  "languages": ["tr", "en", "ar", "ru"],
  "menu_url": "https://qr.ladom.co/ggburger",
  "branches": [
    { "id": "8beb7e3e-852c-428c-828b-62658089a800", "name": "GG Burger", "timezone": "Europe/Istanbul" }
  ]
}

curl https://qr.ladom.co/api/v1/branches/8beb7e3e-852c-428c-828b-62658089a800/menu \
  -H "Authorization: Bearer lqm_YOUR_KEY" \
  -H 'If-None-Match: "kq3…"'

{
  "branch_id": "8beb7e3e-852c-428c-828b-62658089a800",
  "version": "2026-10-22T14:31:15Z",
  "categories": [ { "id": "6c118c2d-…", "parent_id": null, "sort_order": 0,
                    "translations": { "tr": { "name": "Burgerler" }, "…": "…" },
                    "image_url": null, "is_active": true, "updated_at": "…", "deleted_at": null } ],
  "products": [ { "…": "the product above" } ],
  "option_groups": [ { "…": "the option group above" } ]
}

curl -X PATCH https://qr.ladom.co/api/v1/branches/8beb7e3e-852c-428c-828b-62658089a800/products/923fb739-2339-41fe-b846-ba5c41ad21e5/availability \
  -H "Authorization: Bearer lqm_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 4f1c2a9e-stock-out-0001" \
  -d '{ "is_sold_out": true, "source": "pos" }'

{ "id": "923fb739-2339-41fe-b846-ba5c41ad21e5", "type": "product", "is_sold_out": true, "sold_out_source": "pos" }

HTTP/1.1 409 Conflict

{ "error": { "code": "conflict", "message": "It was marked sold out by hand in the LQM panel; only the business can reopen it." } }

POST /branches/8beb7e3e-852c-428c-828b-62658089a800/availability/batch

{
  "items": [
    { "type": "product", "id": "923fb739-2339-41fe-b846-ba5c41ad21e5", "is_sold_out": true },
    { "type": "option",  "id": "944b2d3d-1a79-4a85-b817-3f296156a450", "is_sold_out": false }
  ],
  "source": "pos"
}

200 OK
{
  "results": [
    { "status": "ok", "id": "923fb739-…", "type": "product", "is_sold_out": true, "sold_out_source": "pos" },
    { "status": "conflict", "id": "944b2d3d-…", "type": "option", "message": "It was marked sold out by hand…" }
  ]
}

curl -X PUT https://qr.ladom.co/api/v1/webhooks \
  -H "Authorization: Bearer lqm_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://ladapp.example/api/webhooks/qr-menu",
    "events": ["product.updated", "product.deleted", "category.updated", "category.deleted",
               "option_group.updated", "option_group.deleted", "availability.changed"],
    "secret": "whsec_a-long-random-secret-you-choose"
  }'

POST /api/webhooks/qr-menu HTTP/1.1
Content-Type: application/json
User-Agent: Ladom-Webhooks/1
X-Event-Id: evt_3b8f6c2e-0d4a-4f61-9a57-2c1e9d7b4a10
X-Timestamp: 2026-10-22T14:30:47Z
X-Signature: sha256=5f2c0e…a91b

{
  "id": "evt_3b8f6c2e-0d4a-4f61-9a57-2c1e9d7b4a10",
  "type": "product.updated",
  "branch_id": "8beb7e3e-852c-428c-828b-62658089a800",
  "occurred_at": "2026-10-22T14:30:47Z",
  "data": { "id": "af04129a-aa38-4625-8033-2deecf2fbc39", "changed": ["sku", "tax_rate"] }
}

import { createHmac, timingSafeEqual } from "node:crypto";

// rawBody: the request body exactly as received (before JSON.parse).
export function verifyLadomSignature(rawBody, signatureHeader, secret) {
  const expected = "sha256=" + createHmac("sha256", secret).update(rawBody).digest("hex");
  const got = String(signatureHeader ?? "");
  return got.length === expected.length && timingSafeEqual(Buffer.from(got), Buffer.from(expected));
}

<?php
// $rawBody = file_get_contents('php://input');
// $header  = $_SERVER['HTTP_X_SIGNATURE'] ?? '';
function verify_ladom_signature(string $rawBody, string $header, string $secret): bool {
    $expected = 'sha256=' . hash_hmac('sha256', $rawBody, $secret);
    return hash_equals($expected, $header);
}

import hashlib, hmac

def verify_ladom_signature(raw_body: bytes, header: str, secret: str) -> bool:
    expected = "sha256=" + hmac.new(secret.encode(), raw_body, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, header or "")