FShop Açık Kaynak Ücretsiz E-Ticaret Yazılımı

Tüm Eklentiler

<?php

$baseUrl = 'https://example.com/api/v1';
$apiKey  = 'YOUR_API_KEY';

function apiRequest($method, $url, $apiKey, $data = null)
{
    $ch = curl_init();
    $headers = [
        'X-API-Key: ' . trim($apiKey),
        'Accept: application/json',
    ];
    if ($data !== null) {
        $headers[] = 'Content-Type: application/json';
    }
    curl_setopt_array($ch, [
        CURLOPT_URL => $url,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_CUSTOMREQUEST => $method,
        CURLOPT_HTTPHEADER => $headers,
        CURLOPT_SSL_VERIFYPEER => true,
    ]);
    if ($data !== null) {
        curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data, JSON_UNESCAPED_UNICODE));
    }
    $response = curl_exec($ch);
    $httpCode = (int) curl_getinfo($ch, CURLINFO_HTTP_CODE);
    $error = curl_error($ch);
    curl_close($ch);
    $decoded = json_decode((string) $response, true);
    return [
        'http_code' => $httpCode,
        'curl_error' => $error,
        'response' => is_array($decoded) ? $decoded : $response,
    ];
}

// 1) List categories (0-based page)
$categories = apiRequest('GET', $baseUrl . '/categories?page=0&size=50&active=1', $apiKey);

// 2) Create a simple product
$created = apiRequest('POST', $baseUrl . '/products', $apiKey, [
    'name' => 'API Demo Product',
    'category' => 'Test Category',
    'brand' => 'Test Brand',
    'price' => 149.90,
    'stock' => 20,
    'active' => 1,
    'stock_code' => 'DEMO-001',
]);
$productId = (int) ($created['response']['data']['id'] ?? 0);

// 3) List recent picking orders (0-based page)
$orders = apiRequest(
    'GET',
    $baseUrl . '/orders?page=0&size=20&status=2&date_from=2026-06-01',
    $apiKey
);

print_r([
    'categories_http' => $categories['http_code'],
    'product_id' => $productId,
    'orders_http' => $orders['http_code'],
]);

# 1) Smoke test — categories
curl -s -H "X-API-Key: YOUR_API_KEY" -H "Accept: application/json" \
  "https://example.com/api/v1/categories?page=0&size=20"

# 2) Create product
curl -s -X POST \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "name": "API Demo Product",
    "category": "Test Category",
    "brand": "Test Brand",
    "price": 149.90,
    "stock": 20,
    "active": 1,
    "stock_code": "DEMO-001"
  }' \
  "https://example.com/api/v1/products"

# 3) List picking orders (page is 0-based)
curl -s -H "X-API-Key: YOUR_API_KEY" -H "Accept: application/json" \
  "https://example.com/api/v1/orders?page=0&size=20&status=2&date_from=2026-06-01"

# 4) Mark shipped + cargo (replace 15 with order id)
curl -s -X PATCH \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status":3,"cargoCompany":"Yurtiçi Kargo","trackingNumber":"YT123456789"}' \
  "https://example.com/api/v1/orders/15"

# 5) Attach invoice URL
curl -s -X POST \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/fatura.pdf","name":"Invoice"}' \
  "https://example.com/api/v1/orders/15/invoice"

{
  "success": true,
  "data": { },
  "content": [ ],
  "message": "",
  "meta": { }
}

{
  "success": false,
  "message": "Açıklayıcı hata metni"
}

{
  "success": true,
  "data": [],
  "meta": {
    "total": 5,
    "page": 1,
    "limit": 10,
    "pages": 1
  }
}

{
  "success": false,
  "message": "Geçersiz API anahtarı"
}

<?php

$baseUrl = 'https://example.com/api/v1';
$apiKey  = 'YOUR_API_KEY'; // Admin → API

function apiRequest(string $method, string $url, string $apiKey, ?array $data = null): array
{
    $ch = curl_init();

    $headers = [
        'X-API-Key: ' . trim($apiKey),
        'Accept: application/json',
    ];

    if ($data !== null) {
        $headers[] = 'Content-Type: application/json';
    }

    curl_setopt_array($ch, [
        CURLOPT_URL => $url,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_CUSTOMREQUEST => $method,
        CURLOPT_HTTPHEADER => $headers,
        CURLOPT_SSL_VERIFYPEER => true,
    ]);

    if ($data !== null) {
        curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data, JSON_UNESCAPED_UNICODE));
    }

    $response = curl_exec($ch);
    $httpCode = (int) curl_getinfo($ch, CURLINFO_HTTP_CODE);
    $error = curl_error($ch);
    curl_close($ch);

    $decoded = json_decode((string) $response, true);

    return [
        'http_code' => $httpCode,
        'curl_error' => $error,
        'response' => is_array($decoded) ? $decoded : $response,
    ];
}

// Connection check — categories
$result = apiRequest('GET', $baseUrl . '/categories', $apiKey);
print_r($result);

curl -s -H "X-API-Key: YOUR_API_KEY" \
  -H "Accept: application/json" \
  "https://example.com/api/v1/categories"

{
  "totalElements": 4,
  "content": [
    {
      "id": 3,
      "name": "Vitamin & Takviye",
      "slug": "vitamin-takviye",
      "parentId": 1,
      "parentName": "Sağlık",
      "active": true
    }
  ]
}

<?php

$baseUrl = 'https://example.com/api/v1';
$apiKey  = 'YOUR_API_KEY';

function apiRequest(string $method, string $url, string $apiKey, ?array $data = null): array
{
    $ch = curl_init();
    $headers = [
        'X-API-Key: ' . trim($apiKey),
        'Accept: application/json',
    ];
    if ($data !== null) {
        $headers[] = 'Content-Type: application/json';
    }
    curl_setopt_array($ch, [
        CURLOPT_URL => $url,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_CUSTOMREQUEST => $method,
        CURLOPT_HTTPHEADER => $headers,
        CURLOPT_SSL_VERIFYPEER => true,
    ]);
    if ($data !== null) {
        curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data, JSON_UNESCAPED_UNICODE));
    }
    $response = curl_exec($ch);
    $httpCode = (int) curl_getinfo($ch, CURLINFO_HTTP_CODE);
    $error = curl_error($ch);
    curl_close($ch);
    $decoded = json_decode((string) $response, true);
    return [
        'http_code' => $httpCode,
        'curl_error' => $error,
        'response' => is_array($decoded) ? $decoded : $response,
    ];
}

$result = apiRequest(
    'GET',
    $baseUrl . '/products?page=1&limit=20&q=vitamin&active=1',
    $apiKey
);
print_r($result);

curl -s -H "X-API-Key: YOUR_API_KEY" \
  -H "Accept: application/json" \
  "https://example.com/api/v1/products?page=1&limit=20&q=vitamin&active=1"

{
  "success": true,
  "lang": "tr",
  "data": [
    {
      "id": 5,
      "name": "Multivitamin Complex 60 Tablet",
      "slug": "multivitamin-complex-60",
      "url": "https://example.com/multivitamin-complex-60-5",
      "price": 329,
      "old_price": 399,
      "stock": 200,
      "in_stock": true,
      "active": 1,
      "barcode": "8690000000059",
      "stock_code": "DEMO-MULTI60",
      "id_category": 3,
      "category_name": "Vitamin & Takviye",
      "id_brand": 3,
      "brand_name": "FShop Demo",
      "image_url": "https://example.com/img/products/5.jpg",
      "has_variations": false
    }
  ],
  "meta": {
    "total": 1,
    "page": 1,
    "limit": 20,
    "pages": 1
  }
}

<?php

$baseUrl = 'https://example.com/api/v1';
$apiKey  = 'YOUR_API_KEY';
$productId = 6;

function apiRequest(string $method, string $url, string $apiKey, ?array $data = null): array
{
    $ch = curl_init();
    $headers = [
        'X-API-Key: ' . trim($apiKey),
        'Accept: application/json',
    ];
    if ($data !== null) {
        $headers[] = 'Content-Type: application/json';
    }
    curl_setopt_array($ch, [
        CURLOPT_URL => $url,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_CUSTOMREQUEST => $method,
        CURLOPT_HTTPHEADER => $headers,
        CURLOPT_SSL_VERIFYPEER => true,
    ]);
    if ($data !== null) {
        curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data, JSON_UNESCAPED_UNICODE));
    }
    $response = curl_exec($ch);
    $httpCode = (int) curl_getinfo($ch, CURLINFO_HTTP_CODE);
    $error = curl_error($ch);
    curl_close($ch);
    $decoded = json_decode((string) $response, true);
    return [
        'http_code' => $httpCode,
        'curl_error' => $error,
        'response' => is_array($decoded) ? $decoded : $response,
    ];
}

$result = apiRequest('GET', $baseUrl . '/products/' . (int) $productId, $apiKey);
print_r($result);

curl -s -H "X-API-Key: YOUR_API_KEY" \
  -H "Accept: application/json" \
  "https://example.com/api/v1/products/6"

{
  "success": true,
  "lang": "tr",
  "data": {
    "id": 6,
    "name": "Pamuklu Tişört",
    "slug": "pamuklu-tisort",
    "price": 199.99,
    "old_price": 0,
    "stock": 15,
    "active": 1,
    "barcode": "86991233322",
    "stock_code": "fs123",
    "category_name": "Test Category",
    "brand_name": "Test Brand",
    "description_html": "<p>Yumuşak kumaş</p>",
    "has_variations": true,
    "images": [
      {
        "id": 12,
        "url": "https://example.com/img/products/12.jpg",
        "cover": true
      }
    ],
    "variations": [
      {
        "id": 1,
        "sku": "TSH-RED-M",
        "barcode": "8690000001001",
        "options": { "Color": "Red", "Size": "M" },
        "price": 249.9,
        "stock": 12,
        "active": 1
      }
    ],
    "translations": {
      "tr": {
        "name": "Pamuklu Tişört",
        "slug": "pamuklu-tisort",
        "description_html": "<p>Yumuşak kumaş</p>"
      },
      "en": {
        "name": "Cotton T-Shirt",
        "slug": "cotton-t-shirt",
        "description_html": "<p>Soft fabric</p>"
      }
    }
  }
}

<?php

$baseUrl = 'https://example.com/api/v1';
$apiKey  = 'YOUR_API_KEY';

function apiRequest(string $method, string $url, string $apiKey, ?array $data = null): array
{
    $ch = curl_init();
    $headers = [
        'X-API-Key: ' . trim($apiKey),
        'Accept: application/json',
    ];
    if ($data !== null) {
        $headers[] = 'Content-Type: application/json';
    }
    curl_setopt_array($ch, [
        CURLOPT_URL => $url,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_CUSTOMREQUEST => $method,
        CURLOPT_HTTPHEADER => $headers,
        CURLOPT_SSL_VERIFYPEER => true,
    ]);
    if ($data !== null) {
        curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data, JSON_UNESCAPED_UNICODE));
    }
    $response = curl_exec($ch);
    $httpCode = (int) curl_getinfo($ch, CURLINFO_HTTP_CODE);
    $error = curl_error($ch);
    curl_close($ch);
    $decoded = json_decode((string) $response, true);
    return [
        'http_code' => $httpCode,
        'curl_error' => $error,
        'response' => is_array($decoded) ? $decoded : $response,
    ];
}

// Multi-language product with variations
$payload = [
    'translations' => [
        'tr' => [
            'name' => 'Pamuklu Tişört',
            'slug' => 'pamuklu-tisort',
            'description_html' => '<p>Yumuşak kumaş</p>',
        ],
        'en' => [
            'name' => 'Cotton T-Shirt',
            'slug' => 'cotton-t-shirt',
            'description_html' => '<p>Soft fabric</p>',
        ],
    ],
    'category' => 'Test Category',
    'brand' => 'Test Brand',
    'cost' => 50,
    'price' => 199.99,
    'stock' => 15,
    'active' => 1,
    'barcode' => '86991233322',
    'stock_code' => 'fs123',
    'variations' => [
        [
            'sku' => 'TSH-RED-M',
            'barcode' => '8690000001001',
            'options' => [
                'Color' => 'Red',
                'Size' => 'M',
            ],
            'price' => 249.90,
            'stock' => 12,
            'active' => true,
        ],
    ],
];

$result = apiRequest('POST', $baseUrl . '/products', $apiKey, $payload);
$productId = (int) ($result['response']['data']['id'] ?? 0);
print_r($result);

# Simple create (category / brand by name)
curl -s -X POST \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "name": "Omega 3 Balık Yağı 90 Kapsül",
    "category": "Vitamin & Takviye",
    "brand": "Nutrof",
    "price": 249.90,
    "old_price": 299.90,
    "stock": 50,
    "active": 1,
    "barcode": "8690000000888",
    "stock_code": "OMEGA3-90",
    "description_html": "<p>90 kapsül, soğuk sıkım.</p>"
  }' \
  "https://example.com/api/v1/products"

# Multi-language + variations
curl -s -X POST \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "translations": {
      "tr": { "name": "Pamuklu Tişört", "slug": "pamuklu-tisort", "description_html": "<p>Yumuşak kumaş</p>" },
      "en": { "name": "Cotton T-Shirt", "slug": "cotton-t-shirt", "description_html": "<p>Soft fabric</p>" }
    },
    "category": "Test Category",
    "brand": "Test Brand",
    "cost": 50,
    "price": 199.99,
    "stock": 15,
    "active": 1,
    "barcode": "86991233322",
    "stock_code": "fs123",
    "variations": [
      {
        "sku": "TSH-RED-M",
        "barcode": "8690000001001",
        "options": { "Color": "Red", "Size": "M" },
        "price": 249.90,
        "stock": 12,
        "active": true
      }
    ]
  }' \
  "https://example.com/api/v1/products"

{
  "success": true,
  "message": "Ürün eklendi",
  "lang": "tr",
  "data": {
    "id": 6,
    "name": "Pamuklu Tişört",
    "slug": "pamuklu-tisort",
    "price": 199.99,
    "stock": 15,
    "active": 1,
    "barcode": "86991233322",
    "stock_code": "fs123",
    "category_name": "Test Category",
    "brand_name": "Test Brand",
    "has_variations": true
  }
}

<?php

$baseUrl = 'https://example.com/api/v1';
$apiKey  = 'YOUR_API_KEY';
$productId = 6;

function apiRequest(string $method, string $url, string $apiKey, ?array $data = null): array
{
    $ch = curl_init();
    $headers = [
        'X-API-Key: ' . trim($apiKey),
        'Accept: application/json',
    ];
    if ($data !== null) {
        $headers[] = 'Content-Type: application/json';
    }
    curl_setopt_array($ch, [
        CURLOPT_URL => $url,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_CUSTOMREQUEST => $method,
        CURLOPT_HTTPHEADER => $headers,
        CURLOPT_SSL_VERIFYPEER => true,
    ]);
    if ($data !== null) {
        curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data, JSON_UNESCAPED_UNICODE));
    }
    $response = curl_exec($ch);
    $httpCode = (int) curl_getinfo($ch, CURLINFO_HTTP_CODE);
    $error = curl_error($ch);
    curl_close($ch);
    $decoded = json_decode((string) $response, true);
    return [
        'http_code' => $httpCode,
        'curl_error' => $error,
        'response' => is_array($decoded) ? $decoded : $response,
    ];
}

$payload = [
    'name' => 'Test Name',
    'category' => 'Category Name',
    'brand' => 'Test',
    'cost' => 100,
    'price' => 299.51,
    'stock' => 1,
    'active' => 1,
    'barcode' => 'AS85551212',
    'stock_code' => 'fs123',
    'description_html' => '<p>Test</p><p>Test 2</p>',
];

$result = apiRequest('PATCH', $baseUrl . '/products/' . (int) $productId, $apiKey, $payload);
print_r($result);

curl -s -X PATCH \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "name": "Test Name",
    "category": "Category Name",
    "brand": "Test",
    "cost": 100,
    "price": 299.51,
    "stock": 1,
    "active": 1,
    "barcode": "AS85551212",
    "stock_code": "fs123",
    "description_html": "<p>Test</p><p>Test 2</p>"
  }' \
  "https://example.com/api/v1/products/6"

{
  "success": true,
  "message": "Ürün güncellendi",
  "data": {
    "id": 6,
    "name": "Test Name",
    "slug": "test-name",
    "price": 299.51,
    "stock": 1,
    "active": 1,
    "barcode": "AS85551212",
    "stock_code": "fs123",
    "category_name": "Category Name",
    "brand_name": "Test",
    "description_html": "<p>Test</p><p>Test 2</p>"
  }
}

<?php

$baseUrl = 'https://example.com/api/v1';
$apiKey  = 'YOUR_API_KEY';
$productId = 1;

function apiRequest(string $method, string $url, string $apiKey, ?array $data = null): array
{
    $ch = curl_init();
    $headers = [
        'X-API-Key: ' . trim($apiKey),
        'Accept: application/json',
    ];
    if ($data !== null) {
        $headers[] = 'Content-Type: application/json';
    }
    curl_setopt_array($ch, [
        CURLOPT_URL => $url,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_CUSTOMREQUEST => $method,
        CURLOPT_HTTPHEADER => $headers,
        CURLOPT_SSL_VERIFYPEER => true,
    ]);
    if ($data !== null) {
        curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data, JSON_UNESCAPED_UNICODE));
    }
    $response = curl_exec($ch);
    $httpCode = (int) curl_getinfo($ch, CURLINFO_HTTP_CODE);
    $error = curl_error($ch);
    curl_close($ch);
    $decoded = json_decode((string) $response, true);
    return [
        'http_code' => $httpCode,
        'curl_error' => $error,
        'response' => is_array($decoded) ? $decoded : $response,
    ];
}

$payload = [
    'price' => 500,
    'old_price' => 600,
    'stock' => 10,
    'active' => 1,
];

$result = apiRequest(
    'PATCH',
    $baseUrl . '/products/' . (int) $productId . '/quick',
    $apiKey,
    $payload
);
print_r($result);

# Full quick update
curl -s -X PATCH \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"price":500,"old_price":600,"stock":10,"active":1}' \
  "https://example.com/api/v1/products/1/quick"

# Stock only
curl -s -X PATCH \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"stock":10}' \
  "https://example.com/api/v1/products/1/quick"

{
  "success": true,
  "message": "Ürün hızlı güncellendi",
  "lang": "tr",
  "data": {
    "id": 1,
    "name": "Test Product",
    "price": 500,
    "old_price": 600,
    "stock": 10,
    "active": 1,
    "has_variations": true
  }
}

<?php

$baseUrl = 'https://example.com/api/v1';
$apiKey  = 'YOUR_API_KEY';
$productId = 6;

function apiRequest(string $method, string $url, string $apiKey, ?array $data = null): array
{
    $ch = curl_init();
    $headers = [
        'X-API-Key: ' . trim($apiKey),
        'Accept: application/json',
    ];
    if ($data !== null) {
        $headers[] = 'Content-Type: application/json';
    }
    curl_setopt_array($ch, [
        CURLOPT_URL => $url,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_CUSTOMREQUEST => $method,
        CURLOPT_HTTPHEADER => $headers,
        CURLOPT_SSL_VERIFYPEER => true,
    ]);
    if ($data !== null) {
        curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data, JSON_UNESCAPED_UNICODE));
    }
    $response = curl_exec($ch);
    $httpCode = (int) curl_getinfo($ch, CURLINFO_HTTP_CODE);
    $error = curl_error($ch);
    curl_close($ch);
    $decoded = json_decode((string) $response, true);
    return [
        'http_code' => $httpCode,
        'curl_error' => $error,
        'response' => is_array($decoded) ? $decoded : $response,
    ];
}

function apiUploadImage(string $url, string $apiKey, string $filePath): array
{
    $ch = curl_init();
    curl_setopt_array($ch, [
        CURLOPT_URL => $url,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST => true,
        CURLOPT_HTTPHEADER => [
            'X-API-Key: ' . trim($apiKey),
            'Accept: application/json',
        ],
        CURLOPT_POSTFIELDS => [
            'image' => new CURLFile(
                $filePath,
                mime_content_type($filePath) ?: 'image/jpeg',
                basename($filePath)
            ),
        ],
        CURLOPT_SSL_VERIFYPEER => true,
    ]);
    $response = curl_exec($ch);
    $httpCode = (int) curl_getinfo($ch, CURLINFO_HTTP_CODE);
    $error = curl_error($ch);
    curl_close($ch);
    $decoded = json_decode((string) $response, true);
    return [
        'http_code' => $httpCode,
        'curl_error' => $error,
        'response' => is_array($decoded) ? $decoded : $response,
    ];
}

// Option A — local file
$result = apiUploadImage(
    $baseUrl . '/products/' . $productId . '/image',
    $apiKey,
    __DIR__ . '/sample-product.jpg'
);

// Option B — remote URL
// $result = apiRequest('POST', $baseUrl . '/products/' . $productId . '/image', $apiKey, [
//     'image_url' => 'https://example.com/urun.jpg',
// ]);

print_r($result);

# Multipart file upload
curl -s -X POST \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Accept: application/json" \
  -F "image=@C:/path/urun.jpg" \
  "https://example.com/api/v1/products/6/image"

# From remote URL
curl -s -X POST \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image_url":"https://example.com/urun.jpg"}' \
  "https://example.com/api/v1/products/6/image"

{
  "success": true,
  "message": "Image uploaded",
  "data": {
    "id": 12,
    "product_id": 6,
    "url": "https://example.com/img/products/12.jpg"
  }
}

<?php

$baseUrl = 'https://example.com/api/v1';
$apiKey  = 'YOUR_API_KEY';
$productId = 6;

function apiRequest(string $method, string $url, string $apiKey, ?array $data = null): array
{
    $ch = curl_init();
    $headers = [
        'X-API-Key: ' . trim($apiKey),
        'Accept: application/json',
    ];
    if ($data !== null) {
        $headers[] = 'Content-Type: application/json';
    }
    curl_setopt_array($ch, [
        CURLOPT_URL => $url,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_CUSTOMREQUEST => $method,
        CURLOPT_HTTPHEADER => $headers,
        CURLOPT_SSL_VERIFYPEER => true,
    ]);
    if ($data !== null) {
        curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data, JSON_UNESCAPED_UNICODE));
    }
    $response = curl_exec($ch);
    $httpCode = (int) curl_getinfo($ch, CURLINFO_HTTP_CODE);
    $error = curl_error($ch);
    curl_close($ch);
    $decoded = json_decode((string) $response, true);
    return [
        'http_code' => $httpCode,
        'curl_error' => $error,
        'response' => is_array($decoded) ? $decoded : $response,
    ];
}

$result = apiRequest('DELETE', $baseUrl . '/products/' . (int) $productId, $apiKey);
print_r($result);

curl -s -X DELETE \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Accept: application/json" \
  "https://example.com/api/v1/products/6"

{
  "success": true,
  "message": "Ürün silindi"
}

{
  "translations": {
    "tr": {
      "name": "Pamuklu Tişört",
      "description_html": "<p>Yumuşak kumaş</p>",
      "short_description": "Günlük kullanım"
    },
    "en": {
      "name": "Cotton T-Shirt",
      "description_html": "<p>Soft fabric</p>",
      "short_description": "Everyday wear"
    }
  },
  "category": "Giyim",
  "brand": "Demo Marka",
  "price": 199.99,
  "stock": 15,
  "active": 1,
  "variations": [
    {
      "sku": "TSH-KIRMIZI-M",
      "barcode": "8690000001001",
      "options": {
        "Renk": "Kırmızı",
        "Beden": "M"
      },
      "price": 249.90,
      "stock": 12,
      "active": true
    },
    {
      "sku": "TSH-KIRMIZI-L",
      "barcode": "8690000001002",
      "options": {
        "Renk": "Kırmızı",
        "Beden": "L"
      },
      "price": 249.90,
      "stock": 8,
      "active": true
    }
  ]
}

<?php

$baseUrl = 'https://example.com/api/v1';
$apiKey  = 'YOUR_API_KEY';

$payload = [
    'translations' => [
        'tr' => [
            'name' => 'Pamuklu Tişört',
            'slug' => 'pamuklu-tisort',
            'description_html' => '<p>Yumuşak kumaş</p>',
            'short_description' => 'Günlük kullanım',
        ],
        'en' => [
            'name' => 'Cotton T-Shirt',
            'slug' => 'cotton-t-shirt',
            'description_html' => '<p>Soft fabric</p>',
            'short_description' => 'Everyday wear',
        ],
    ],
    'category' => 'Test Category',
    'brand' => 'Test Brand',
    'cost' => 50,
    'price' => 199.99,
    'stock' => 15,
    'active' => 1,
    'barcode' => '86991233322',
    'stock_code' => 'fs123',
    'variations' => [
        [
            'sku' => 'TSH-RED-M',
            'barcode' => '8690000001001',
            'options' => [
                'Color' => 'Red',
                'Size' => 'M',
            ],
            'price' => 249.90,
            'stock' => 12,
            'active' => true,
        ],
        [
            'sku' => 'TSH-RED-L',
            'barcode' => '8690000001002',
            'options' => [
                'Color' => 'Red',
                'Size' => 'L',
            ],
            'price' => 249.90,
            'stock' => 8,
            'active' => true,
        ],
    ],
];

$ch = curl_init($baseUrl . '/products');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'X-API-Key: ' . trim($apiKey),
        'Content-Type: application/json',
        'Accept: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode($payload, JSON_UNESCAPED_UNICODE),
    CURLOPT_SSL_VERIFYPEER => true,
]);
$response = curl_exec($ch);
$httpCode = (int) curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

echo $httpCode . PHP_EOL;
echo $response;

curl -s -X POST \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "translations": {
      "tr": {
        "name": "Pamuklu Tişört",
        "slug": "pamuklu-tisort",
        "description_html": "<p>Yumuşak kumaş</p>",
        "short_description": "Günlük kullanım"
      },
      "en": {
        "name": "Cotton T-Shirt",
        "slug": "cotton-t-shirt",
        "description_html": "<p>Soft fabric</p>",
        "short_description": "Everyday wear"
      }
    },
    "category": "Test Category",
    "brand": "Test Brand",
    "cost": 50,
    "price": 199.99,
    "stock": 15,
    "active": 1,
    "barcode": "86991233322",
    "stock_code": "fs123",
    "variations": [
      {
        "sku": "TSH-RED-M",
        "barcode": "8690000001001",
        "options": { "Color": "Red", "Size": "M" },
        "price": 249.90,
        "stock": 12,
        "active": true
      },
      {
        "sku": "TSH-RED-L",
        "barcode": "8690000001002",
        "options": { "Color": "Red", "Size": "L" },
        "price": 249.90,
        "stock": 8,
        "active": true
      }
    ]
  }' \
  "https://example.com/api/v1/products"

{
  "success": true,
  "message": "Ürün eklendi",
  "lang": "tr",
  "data": {
    "id": 6,
    "name": "Pamuklu Tişört",
    "slug": "pamuklu-tisort",
    "price": 199.99,
    "stock": 15,
    "active": 1,
    "barcode": "86991233322",
    "stock_code": "fs123",
    "category_name": "Test Category",
    "brand_name": "Test Brand",
    "has_variations": true
  }
}

<?php

$baseUrl = 'https://example.com/api/v1';
$apiKey  = 'YOUR_API_KEY';

function apiRequest(string $method, string $url, string $apiKey, ?array $data = null): array
{
    $ch = curl_init();
    $headers = [
        'X-API-Key: ' . trim($apiKey),
        'Accept: application/json',
    ];
    if ($data !== null) {
        $headers[] = 'Content-Type: application/json';
    }
    curl_setopt_array($ch, [
        CURLOPT_URL => $url,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_CUSTOMREQUEST => $method,
        CURLOPT_HTTPHEADER => $headers,
        CURLOPT_SSL_VERIFYPEER => true,
    ]);
    if ($data !== null) {
        curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data, JSON_UNESCAPED_UNICODE));
    }
    $response = curl_exec($ch);
    $httpCode = (int) curl_getinfo($ch, CURLINFO_HTTP_CODE);
    $error = curl_error($ch);
    curl_close($ch);
    $decoded = json_decode((string) $response, true);
    return [
        'http_code' => $httpCode,
        'curl_error' => $error,
        'response' => is_array($decoded) ? $decoded : $response,
    ];
}

$result = apiRequest('GET', $baseUrl . '/categories?page=0&size=100&active=1', $apiKey);
print_r($result);

curl -s -H "X-API-Key: YOUR_API_KEY" \
  -H "Accept: application/json" \
  "https://example.com/api/v1/categories?page=0&size=100&active=1"

{
  "totalElements": 4,
  "content": [
    {
      "id": 3,
      "name": "Vitamin & Takviye",
      "slug": "vitamin-takviye",
      "parentId": 1,
      "parentName": "Sağlık",
      "active": true
    }
  ]
}

<?php

$baseUrl = 'https://example.com/api/v1';
$apiKey  = 'YOUR_API_KEY';

function apiRequest(string $method, string $url, string $apiKey, ?array $data = null): array
{
    $ch = curl_init();
    $headers = [
        'X-API-Key: ' . trim($apiKey),
        'Accept: application/json',
    ];
    if ($data !== null) {
        $headers[] = 'Content-Type: application/json';
    }
    curl_setopt_array($ch, [
        CURLOPT_URL => $url,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_CUSTOMREQUEST => $method,
        CURLOPT_HTTPHEADER => $headers,
        CURLOPT_SSL_VERIFYPEER => true,
    ]);
    if ($data !== null) {
        curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data, JSON_UNESCAPED_UNICODE));
    }
    $response = curl_exec($ch);
    $httpCode = (int) curl_getinfo($ch, CURLINFO_HTTP_CODE);
    $error = curl_error($ch);
    curl_close($ch);
    $decoded = json_decode((string) $response, true);
    return [
        'http_code' => $httpCode,
        'curl_error' => $error,
        'response' => is_array($decoded) ? $decoded : $response,
    ];
}

$result = apiRequest('GET', $baseUrl . '/brands?page=0&size=100&active=1', $apiKey);
print_r($result);

curl -s -H "X-API-Key: YOUR_API_KEY" \
  -H "Accept: application/json" \
  "https://example.com/api/v1/brands?page=0&size=100&active=1"

{
  "totalElements": 2,
  "content": [
    {
      "id": 1,
      "name": "Nutrof",
      "slug": "nutrof",
      "active": true
    }
  ]
}

<?php

$baseUrl = 'https://example.com/api/v1';
$apiKey  = 'YOUR_API_KEY';

function apiRequest(string $method, string $url, string $apiKey, ?array $data = null): array
{
    $ch = curl_init();
    $headers = [
        'X-API-Key: ' . trim($apiKey),
        'Accept: application/json',
    ];
    if ($data !== null) {
        $headers[] = 'Content-Type: application/json';
    }
    curl_setopt_array($ch, [
        CURLOPT_URL => $url,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_CUSTOMREQUEST => $method,
        CURLOPT_HTTPHEADER => $headers,
        CURLOPT_SSL_VERIFYPEER => true,
    ]);
    if ($data !== null) {
        curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data, JSON_UNESCAPED_UNICODE));
    }
    $response = curl_exec($ch);
    $httpCode = (int) curl_getinfo($ch, CURLINFO_HTTP_CODE);
    $error = curl_error($ch);
    curl_close($ch);
    $decoded = json_decode((string) $response, true);
    return [
        'http_code' => $httpCode,
        'curl_error' => $error,
        'response' => is_array($decoded) ? $decoded : $response,
    ];
}

$result = apiRequest(
    'GET',
    $baseUrl . '/orders?page=0&size=20&status=2&date_from=2026-06-10&date_to=2026-07-30',
    $apiKey
);
print_r($result);

curl -s -H "X-API-Key: YOUR_API_KEY" \
  -H "Accept: application/json" \
  "https://example.com/api/v1/orders?page=0&size=20&status=2&date_from=2026-06-10&date_to=2026-07-30"

{
  "totalElements": 1,
  "totalPages": 1,
  "page": 0,
  "size": 20,
  "content": [
    {
      "id": 15,
      "orderNumber": "FS-20260617-0015",
      "customerFirstName": "Ali",
      "customerLastName": "Yılmaz",
      "customerEmail": "ali@ornek.com",
      "customerPhone": "05551234567",
      "packageTotalPrice": 899.0,
      "paymentMethod": "bankwire",
      "paymentLabel": "Havale / EFT",
      "statusCode": 2,
      "status": "Picking",
      "statusLabel": "Hazırlanıyor",
      "cargoCompany": "",
      "trackingNumber": "",
      "commercial": false,
      "orderDate": 1718611200000,
      "invoice": null,
      "shipmentAddress": {
        "firstName": "Ali",
        "lastName": "Yılmaz",
        "city": "İstanbul",
        "district": "Kadıköy",
        "address1": "Moda Cad. No:5",
        "fullAddress": "İstanbul / Kadıköy — Moda Cad. No:5",
        "phone": "05551234567",
        "countryCode": "TR"
      },
      "lines": [
        {
          "lineId": 42,
          "contentId": 1,
          "productName": "SolNutrof Total 30 Kapsül",
          "quantity": 1,
          "stockCode": "SOLNUTROF30",
          "barcode": "8690000000011",
          "lineUnitPrice": 899.0,
          "lineAmount": 899.0,
          "vatRate": 20.0,
          "orderLineItemStatusName": "Picking"
        }
      ]
    }
  ]
}

<?php

$baseUrl = 'https://example.com/api/v1';
$apiKey  = 'YOUR_API_KEY';
$orderId = 15;

function apiRequest(string $method, string $url, string $apiKey, ?array $data = null): array
{
    $ch = curl_init();
    $headers = [
        'X-API-Key: ' . trim($apiKey),
        'Accept: application/json',
    ];
    if ($data !== null) {
        $headers[] = 'Content-Type: application/json';
    }
    curl_setopt_array($ch, [
        CURLOPT_URL => $url,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_CUSTOMREQUEST => $method,
        CURLOPT_HTTPHEADER => $headers,
        CURLOPT_SSL_VERIFYPEER => true,
    ]);
    if ($data !== null) {
        curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data, JSON_UNESCAPED_UNICODE));
    }
    $response = curl_exec($ch);
    $httpCode = (int) curl_getinfo($ch, CURLINFO_HTTP_CODE);
    $error = curl_error($ch);
    curl_close($ch);
    $decoded = json_decode((string) $response, true);
    return [
        'http_code' => $httpCode,
        'curl_error' => $error,
        'response' => is_array($decoded) ? $decoded : $response,
    ];
}

$result = apiRequest('GET', $baseUrl . '/orders/' . (int) $orderId, $apiKey);
print_r($result);

curl -s -H "X-API-Key: YOUR_API_KEY" \
  -H "Accept: application/json" \
  "https://example.com/api/v1/orders/15"

{
  "id": 15,
  "orderNumber": "FS-20260617-0015",
  "customerFirstName": "Ali",
  "customerLastName": "Yılmaz",
  "customerEmail": "ali@ornek.com",
  "packageTotalPrice": 899.0,
  "statusCode": 2,
  "status": "Picking",
  "statusLabel": "Hazırlanıyor",
  "cargoCompany": "",
  "trackingNumber": "",
  "invoice": null,
  "lines": [
    {
      "lineId": 42,
      "productName": "SolNutrof Total 30 Kapsül",
      "quantity": 1,
      "stockCode": "SOLNUTROF30",
      "lineAmount": 899.0
    }
  ]
}

<?php

$baseUrl = 'https://example.com/api/v1';
$apiKey  = 'YOUR_API_KEY';
$orderId = 15;

function apiRequest(string $method, string $url, string $apiKey, ?array $data = null): array
{
    $ch = curl_init();
    $headers = [
        'X-API-Key: ' . trim($apiKey),
        'Accept: application/json',
    ];
    if ($data !== null) {
        $headers[] = 'Content-Type: application/json';
    }
    curl_setopt_array($ch, [
        CURLOPT_URL => $url,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_CUSTOMREQUEST => $method,
        CURLOPT_HTTPHEADER => $headers,
        CURLOPT_SSL_VERIFYPEER => true,
    ]);
    if ($data !== null) {
        curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data, JSON_UNESCAPED_UNICODE));
    }
    $response = curl_exec($ch);
    $httpCode = (int) curl_getinfo($ch, CURLINFO_HTTP_CODE);
    $error = curl_error($ch);
    curl_close($ch);
    $decoded = json_decode((string) $response, true);
    return [
        'http_code' => $httpCode,
        'curl_error' => $error,
        'response' => is_array($decoded) ? $decoded : $response,
    ];
}

$payload = [
    'status' => 3,
    'cargoCompany' => 'Yurtiçi Kargo',
    'trackingNumber' => 'YT123456789',
];

$result = apiRequest('PATCH', $baseUrl . '/orders/' . (int) $orderId, $apiKey, $payload);
print_r($result);

curl -s -X PATCH \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "status": 3,
    "cargoCompany": "Yurtiçi Kargo",
    "trackingNumber": "YT123456789"
  }' \
  "https://example.com/api/v1/orders/15"

{
  "success": true,
  "message": "Sipariş güncellendi",
  "content": {
    "id": 15,
    "orderNumber": "FS-20260617-0015",
    "statusCode": 3,
    "status": "Shipped",
    "statusLabel": "Kargoda",
    "cargoCompany": "Yurtiçi Kargo",
    "trackingNumber": "YT123456789"
  }
}

<?php

$baseUrl = 'https://example.com/api/v1';
$apiKey  = 'YOUR_API_KEY';
$orderId = 15;

function apiRequest(string $method, string $url, string $apiKey, ?array $data = null): array
{
    $ch = curl_init();
    $headers = [
        'X-API-Key: ' . trim($apiKey),
        'Accept: application/json',
    ];
    if ($data !== null) {
        $headers[] = 'Content-Type: application/json';
    }
    curl_setopt_array($ch, [
        CURLOPT_URL => $url,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_CUSTOMREQUEST => $method,
        CURLOPT_HTTPHEADER => $headers,
        CURLOPT_SSL_VERIFYPEER => true,
    ]);
    if ($data !== null) {
        curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data, JSON_UNESCAPED_UNICODE));
    }
    $response = curl_exec($ch);
    $httpCode = (int) curl_getinfo($ch, CURLINFO_HTTP_CODE);
    $error = curl_error($ch);
    curl_close($ch);
    $decoded = json_decode((string) $response, true);
    return [
        'http_code' => $httpCode,
        'curl_error' => $error,
        'response' => is_array($decoded) ? $decoded : $response,
    ];
}

// Attach invoice URL
$result = apiRequest('POST', $baseUrl . '/orders/' . $orderId . '/invoice', $apiKey, [
    'url' => 'https://example.com/fatura.pdf',
    'name' => 'Fatura',
]);
print_r($result);

// Remove invoice
// $result = apiRequest('DELETE', $baseUrl . '/orders/' . $orderId . '/invoice', $apiKey);

# Attach invoice URL
curl -s -X POST \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/fatura.pdf","name":"Fatura"}' \
  "https://example.com/api/v1/orders/15/invoice"

# Remove invoice
curl -s -X DELETE \
  -H "X-API-Key: YOUR_API_KEY" \
  "https://example.com/api/v1/orders/15/invoice"

{
  "success": true,
  "message": "Fatura kaydedildi",
  "content": {
    "id": 15,
    "orderNumber": "FS-20260617-0015",
    "invoice": {
      "type": "url",
      "url": "https://example.com/fatura.pdf",
      "name": "Fatura"
    }
  }
}

# 1) List picking orders (status=2), page is 0-based
curl -s -H "X-API-Key: YOUR_API_KEY" -H "Accept: application/json" \
  "https://example.com/api/v1/orders?page=0&size=20&status=2&date_from=2026-06-01&date_to=2026-07-30"

# 2) Mark order 15 as shipped + cargo tracking
curl -s -X PATCH \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "status": 3,
    "cargoCompany": "Yurtiçi Kargo",
    "trackingNumber": "YT123456789"
  }' \
  "https://example.com/api/v1/orders/15"

# 3) Attach public invoice URL
curl -s -X POST \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "url": "https://example.com/fatura.pdf",
    "name": "Fatura"
  }' \
  "https://example.com/api/v1/orders/15/invoice"

// Cart AJAX — CSRF from global csrfToken (header.tpl) or meta[name="csrf-token"]
(function () {
  function getCsrfToken() {
    if (typeof window.csrfToken === 'string' && window.csrfToken !== '') {
      return window.csrfToken;
    }
    var meta = document.querySelector('meta[name="csrf-token"]');
    return meta ? meta.getAttribute('content') : '';
  }

  function cartRequest(action, body) {
    var data = Object.assign({ action: action, token: getCsrfToken() }, body || {});
    return fetch('/api/cart.php', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/x-www-form-urlencoded; charset=UTF-8',
        'X-CSRF-Token': getCsrfToken(),
        'Accept': 'application/json'
      },
      credentials: 'same-origin',
      body: new URLSearchParams(data).toString()
    }).then(function (res) {
      return res.json();
    });
  }

  // Add product id 12 (optional variation)
  cartRequest('add', {
    id_product: '12',
    id_variation: '0',
    qty: '1'
  }).then(function (json) {
    console.log(json);
  });
})();

// Login via storefront auth API (session + CSRF, not X-API-Key)
(function () {
  function getCsrfToken() {
    if (typeof window.csrfToken === 'string' && window.csrfToken !== '') {
      return window.csrfToken;
    }
    var meta = document.querySelector('meta[name="csrf-token"]');
    return meta ? meta.getAttribute('content') : '';
  }

  fetch('/api/auth.php', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/x-www-form-urlencoded; charset=UTF-8',
      'X-CSRF-Token': getCsrfToken(),
      'Accept': 'application/json'
    },
    credentials: 'same-origin',
    body: new URLSearchParams({
      action: 'login',
      token: getCsrfToken(),
      login: 'customer@example.com',
      password: 'secret',
      remember: '1'
    }).toString()
  })
    .then(function (res) { return res.json(); })
    .then(function (json) {
      console.log(json);
      if (json.success && json.redirect) {
        window.location.href = json.redirect;
      }
    });
})();

curl -s "https://yoursite.com/api/cron.php?action=currency&token=YOUR_SHOP_TOKEN"

curl -s -X POST \
  -H "X-Cron-Token: YOUR_SHOP_TOKEN" \
  "https://yoursite.com/api/cron.php?action=currency"

curl -s "https://yoursite.com/api/cron.php?action=abandoned-cart&token=YOUR_SHOP_TOKEN"

curl -s "https://yoursite.com/api/module.php?m=MODULE_NAME&action=cron&token=YOUR_SHOP_TOKEN"

curl -s "https://yoursite.com/api/marketplace.php?action=cron&type=orders&platform=trendyol&token=YOUR_SHOP_TOKEN"

curl -s "https://yoursite.com/api/marketplace.php?action=cron&type=questions&platform=hepsiburada&token=YOUR_SHOP_TOKEN"

# Her 30 dakikada döviz
*/30 * * * * curl -s "https://yoursite.com/api/cron.php?action=currency&token=YOUR_SHOP_TOKEN" >/dev/null 2>&1

# Her saat terk edilmiş sepet (modül kuruluysa)
0 * * * * curl -s "https://yoursite.com/api/cron.php?action=abandoned-cart&token=YOUR_SHOP_TOKEN" >/dev/null 2>&1

# Currency / FX product price refresh
curl -s "https://example.com/api/cron.php?action=currency&token=YOUR_SHOP_TOKEN"

# Same via header
curl -s -H "X-Cron-Token: YOUR_SHOP_TOKEN" \
  "https://example.com/api/cron.php?action=currency"

# Abandoned-cart reminders (module must be installed)
curl -s "https://example.com/api/cron.php?action=abandoned-cart&token=YOUR_SHOP_TOKEN"

# Module cron (example: reviews invite job)
curl -s "https://example.com/api/module.php?m=reviews&action=cron&token=YOUR_SHOP_TOKEN"

# Marketplace order sync (Trendyol)
curl -s "https://example.com/api/marketplace.php?action=cron&type=orders&platform=trendyol&token=YOUR_SHOP_TOKEN"

# Marketplace Q&A sync (Hepsiburada), no stock push to marketplace
curl -s "https://example.com/api/marketplace.php?action=cron&type=questions&platform=hepsiburada&send=0&token=YOUR_SHOP_TOKEN"