Ürün Detayı

Belirtilen ürünün detay bilgilerini getirir.

Endpoint

GET /kolaybi/v1/products/{product_id}

Parametreler

Parametre	Tip	Zorunlu	Açıklama
product_id	integer	Evet	Detayı görüntülenecek ürün ID'si

Örnekler

cURL

curl -X GET "https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/products/1" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Channel: YOUR_CHANNEL"

JavaScript

async function getProductDetail(productId) {
  const response = await fetch(
    `https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/products/${productId}`,
    {
      method: "GET",
      headers: {
        Authorization: `Bearer ${accessToken}`,
        Channel: channel,
      },
    }
  );

  return await response.json();
}

// Kullanım
const product = await getProductDetail(1);

PHP

function getProductDetail($productId) {
    $url = "https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/products/{$productId}";

    $ch = curl_init();
    curl_setopt_array($ch, [
        CURLOPT_URL => $url,
        CURLOPT_HTTPHEADER => [
            'Authorization: Bearer ' . $accessToken,
            'Channel: ' . $channel
        ],
        CURLOPT_RETURNTRANSFER => true
    ]);

    $response = curl_exec($ch);
    curl_close($ch);

    return json_decode($response, true);
}

// Kullanım
$product = getProductDetail(1);

Python

import requests

def get_product_detail(product_id):
    url = f"https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/products/{product_id}"
    headers = {
        "Authorization": f"Bearer {access_token}",
        "Channel": channel
    }

    response = requests.get(url, headers=headers)
    return response.json()

# Kullanım
product = get_product_detail(1)

C#

using System;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Threading.Tasks;
using Newtonsoft.Json;

async Task<dynamic> GetProductDetailAsync(int productId)
{
    using var client = new HttpClient();

    var request = new HttpRequestMessage(HttpMethod.Get,
        $"https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/products/{productId}");

    request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", accessToken);
    request.Headers.Add("Channel", channel);

    var response = await client.SendAsync(request);
    var content = await response.Content.ReadAsStringAsync();
    return JsonConvert.DeserializeObject<dynamic>(content);
}

// Kullanım
var product = await GetProductDetailAsync(1);

Yanıt

Başarılı Yanıt

{
  "data": {
    "id": 1,
    "product_type": "good",
    "name": "Örnek Ürün",
    "code": "PRD-001",
    "vat_type": "PERCENTAGE",
    "vat_value": 20,
    "barcode": "1234567890123",
    "description": "Bu bir örnek ürün açıklamasıdır",
    "discount_type": "PERCENTAGE",
    "discount_value": 5,
    "stock_unit": 1,
    "stock_multiplier": 1,
    "purchase_unit": 1,
    "purchase_stock_multiplier": 1,
    "purchase_unit_description": "kutu",
    "purchase_price": 80,
    "purchase_currency": "try",
    "sale_unit": 1,
    "sale_stock_multiplier": 1,
    "sale_unit_description": "adet",
    "sale_price": 100,
    "sale_currency": "try",
    "total_stock_quantity": 50,
    "tags": [
      {
        "id": 12,
        "name": "e-ticaret"
      }
    ]
  }
}

Yanıt Alanları

Alan	Tip	Açıklama
id	integer	Ürün ID
product_type	string	good / service
name	string	Ürün adı
code	string	Ürün kodu
vat_type	string	KDV tipi (PERCENTAGE, NUMERIC)
vat_value	number	KDV oranı
barcode	string	Barkod
description	string	Ürün açıklaması
discount_type	string	İndirim tipi
discount_value	number	İndirim değeri
stock_unit	number	Stok birimi
stock_multiplier	number	Stok birim çarpanı
purchase_unit	number	Alış birimi
purchase_stock_multiplier	number	Alış birim çarpanı
purchase_unit_description	string	Alış birim açıklaması
purchase_price	number	Alış fiyatı
purchase_currency	string	Alış para birimi
sale_unit	number	Satış birimi
sale_stock_multiplier	number	Satış birim çarpanı
sale_unit_description	string	Satış birim açıklaması
sale_price	number	Satış fiyatı
sale_currency	string	Satış para birimi
total_stock_quantity	number	Toplam stok miktarı (negatif olabilir)
tags	array	Ürüne bağlı etiketler

Etiket Alanları (tags)

Alan	Tip	Açıklama
id	integer	Etiket ID değeri
name	string	Etiket adı
description	string	Etiket açıklaması (varsa)