Ü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,
    "name": "Örnek Ürün",
    "code": "PRD-001",
    "barcode": "1234567890123",
    "description": "Bu bir örnek ürün açıklamasıdır",
    "type": "good",
    "price": 100.0,
    "price_currency": "TRY",
    "vat_rate": 20,
    "quantity": 50,
    "unit": "adet",
    "category": "Elektronik",
    "created_at": "2024-01-01T00:00:00Z",
    "updated_at": "2024-01-15T10:30:00Z"
  }
}

Yanıt Alanları

Alan	Tip	Açıklama
id	integer	Ürün ID
name	string	Ürün adı
code	string	Ürün kodu
barcode	string	Barkod
description	string	Ürün açıklaması
type	string	Ürün tipi
price	number	Fiyat
price_currency	string	Para birimi
vat_rate	integer	KDV oranı
quantity	number	Stok miktarı
unit	string	Birim
category	string	Kategori
created_at	string	Oluşturulma tarihi
updated_at	string	Güncellenme tarihi

Kurallar

Önemli

• Ürün ID: Geçerli bir ürün ID'si olmalı
• Erişim: Sadece şirketinize ait ürünlere erişebilirsiniz
• Güncelleme: updated_at alanı son güncelleme tarihini gösterir
• Stok: quantity alanı mevcut stok miktarını gösterir