SoftOK — API Platformă externă

https://alwady.softok.cloud/api-platform

Autentificare

Toate endpoint-urile (exceptând această pagină) necesită API key.

• Header recomandat: X-Api-Key: <cheie>
• Alternativ: Authorization: Bearer <cheie>

Cheia se configurează în api-platform/config.php (API_KEY). Valoarea curentă pe acest server:

sk_a3b42c91d4e6a1b2

Schimbă cheia înainte de producție. Opțional setează PLATFORM_USER_ID (user SoftOK pe bonuri; 0 = primul user activ).

Configurare bază de date

Conexiunea MySQL se setează tot în api-platform/config.php (nu folosește db_connection.txt din API-ul Android):

'DB_SERVER'   => '192.168.0.170',
'DB_PORT'     => 3306,
'DB_DATABASE' => 'softok',
'DB_USER'     => 'softok',
'DB_PASSWORD' => '***',
'DB_POSID'    => 1,

Format răspuns

Succes:

{ "ok": true, "data": { ... } }

Eroare:

{ "ok": false, "error": "mesaj" }

Coduri HTTP uzuale: 400 date invalide, 401 neautorizat, 404 negăsit, 405 metodă greșită, 500 eroare server.

Endpoint-uri

1. Categorii

GET https://alwady.softok.cloud/api-platform/categories.php

Returnează categoriile active care au cel puțin un produs vandabil (aceeași logică ca API-ul Android).

Exemplu curl

curl -s -H "X-Api-Key: sk_a3b42c91d4e6a1b2" \
  "https://alwady.softok.cloud/api-platform/categories.php"

Răspuns exemplu

{
  "ok": true,
  "data": {
    "items": [
      { "id": 3, "name": "Pizza", "tipCategorie": "Bucatarie" },
      { "id": 5, "name": "Bauturi", "tipCategorie": "Bar" }
    ]
  }
}

2. Produse

GET https://alwady.softok.cloud/api-platform/products.php

Query params

Exemplu curl

curl -s -H "X-Api-Key: sk_a3b42c91d4e6a1b2" \
  "https://alwady.softok.cloud/api-platform/products.php?categoryId=3&limit=50"

curl -s -H "X-Api-Key: sk_a3b42c91d4e6a1b2" \
  "https://alwady.softok.cloud/api-platform/products.php?q=margherita"

Răspuns exemplu

{
  "ok": true,
  "data": {
    "items": [
      {
        "id": 10,
        "name": "Pizza Margherita",
        "barcode": "2000010",
        "price": 32.5,
        "stock": 0,
        "description": "",
        "categoryId": 3,
        "subcategoryId": 1,
        "categoryTipCategorie": "Bucatarie"
      }
    ]
  }
}

3. Creare comandă

POST https://alwady.softok.cloud/api-platform/orders.php

Body JSON. Comanda intră în SoftOK ca bon în așteptare + oglindă bucătărie, pe sala Online / prima masă.

Body

Exemplu curl

curl -s -X POST \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: sk_a3b42c91d4e6a1b2" \
  -d '{
    "externalOrderId": "PLT-12345",
    "customerName": "Ion Popescu",
    "customerPhone": "0700000000",
    "notes": "fara ceapa",
    "lines": [
      { "productId": 10, "qty": 2, "comment": "extra sos" },
      { "productId": 22, "qty": 1 }
    ]
  }' \
  "https://alwady.softok.cloud/api-platform/orders.php"

Răspuns exemplu

{
  "ok": true,
  "data": {
    "orderId": 1582,
    "externalOrderId": "PLT-12345",
    "nrBon": 421,
    "nrZi": 12,
    "totalBon": 78.5,
    "salaId": 4,
    "masaId": 18,
    "idempotent": false
  }
}

orderId = ID bon așteptare SoftOK (BonuriAsteptare.Id). Folosește-l la status.

4. Status comandă

GET https://alwady.softok.cloud/api-platform/order-status.php

Query params

Furnizează unul dintre cele două.

Exemple curl

curl -s -H "X-Api-Key: sk_a3b42c91d4e6a1b2" \
  "https://alwady.softok.cloud/api-platform/order-status.php?orderId=1582"

curl -s -H "X-Api-Key: sk_a3b42c91d4e6a1b2" \
  "https://alwady.softok.cloud/api-platform/order-status.php?externalOrderId=PLT-12345"

Răspuns exemplu

{
  "ok": true,
  "data": {
    "orderId": 1582,
    "externalOrderId": "PLT-12345",
    "nrBon": 421,
    "nrZi": 12,
    "totalBon": 78.5,
    "salaId": 4,
    "masaId": 18,
    "bonStatus": 1,
    "status": "preparing",
    "lines": [
      {
        "lineId": 9001,
        "productId": 10,
        "name": "Pizza Margherita",
        "qty": 2,
        "comment": "extra sos",
        "prepStatus": 1,
        "status": "preparing"
      },
      {
        "lineId": 9002,
        "productId": 22,
        "name": "Cola 0.5L",
        "qty": 1,
        "comment": "",
        "prepStatus": 0,
        "status": "received"
      }
    ]
  }
}

Mapare status preparare

Status agregat comandă (data.status):

• received — toate liniile la 0
• preparing — cel puțin o linie ≥ 1, dar nu toate gata
• ready — toate liniile la 2
• unknown — fără linii

Erori tipice

Flux recomandat pentru platformă

1. Sincronizează catalogul: GET /categories.php apoi GET /products.php
2. La checkout: POST /orders.php cu externalOrderId unic + linii
3. Polling status: GET /order-status.php?orderId=... până la ready