Rafplan API - Hizli Baslangic Kilavuzu

# Urun listesi
curl -s -H "X-API-Key: rfp_live_xxxxxxxxxxxx" \
  "https://rafplan.com/api/v1/products?page=1&limit=10"

# Urun detayi
curl -s -H "X-API-Key: rfp_live_xxxxxxxxxxxx" \
  "https://rafplan.com/api/v1/products/f47ac10b-58cc-4372-a567-0e02b2c3d479"

# Sube listesi (sehir filtresi)
curl -s -H "X-API-Key: rfp_live_xxxxxxxxxxxx" \
  "https://rafplan.com/api/v1/branches?city=Istanbul&page=1&limit=20"

# Planogram detayi (raflar ve urunler dahil)
curl -s -H "X-API-Key: rfp_live_xxxxxxxxxxxx" \
  "https://rafplan.com/api/v1/planograms/c3d4e5f6-7890-1234-abcd-ef4567890123"

const API_KEY = 'rfp_live_xxxxxxxxxxxx'
const BASE_URL = 'https://rafplan.com/api/v1'

// --- Tip Tanimlari ---

interface PaginationMeta {
  requestId: string
  timestamp: string
  page: number
  limit: number
  total: number
  totalPages: number
}

interface Product {
  id: string
  name: string
  barcode: string
  platformCode: string
  brandId: string | null
  width: number
  height: number
  depth: number
  weight: number | null
  imageUrl: string | null
  createdAt: string
  updatedAt: string
}

interface ApiResponse<T> {
  data: T
  meta: PaginationMeta
}

interface ApiError {
  error: { code: string; message: string; details?: Record<string, unknown> }
}

// --- API Client ---

async function apiRequest<T>(path: string): Promise<T> {
  const response = await fetch(`${BASE_URL}${path}`, {
    headers: { 'X-API-Key': API_KEY },
  })

  if (!response.ok) {
    const err: ApiError = await response.json()
    throw new Error(`[${err.error.code}] ${err.error.message}`)
  }

  return response.json()
}

// --- Kullanim ---

// Urun listesi
const products = await apiRequest<ApiResponse<Product[]>>(
  '/products?page=1&limit=10'
)
console.log(`Toplam ${products.meta.total} urun, sayfa ${products.meta.page}/${products.meta.totalPages}`)

// Urun detayi
const product = await apiRequest<{ data: Product; meta: { requestId: string } }>(
  '/products/f47ac10b-58cc-4372-a567-0e02b2c3d479'
)
console.log(product.data.name, product.data.barcode)

// Tum sayfalari iterasyon ile cek
async function fetchAllProducts(): Promise<Product[]> {
  const all: Product[] = []
  let page = 1

  while (true) {
    const res = await apiRequest<ApiResponse<Product[]>>(
      `/products?page=${page}&limit=100`
    )
    all.push(...res.data)
    if (page >= res.meta.totalPages) break
    page++
  }

  return all
}

import requests

API_KEY = "rfp_live_xxxxxxxxxxxx"
BASE_URL = "https://rafplan.com/api/v1"

headers = {"X-API-Key": API_KEY}


def api_request(path: str, params: dict | None = None) -> dict:
    """API istegi gonder ve JSON dondur."""
    response = requests.get(f"{BASE_URL}{path}", headers=headers, params=params)
    response.raise_for_status()
    return response.json()


# Urun listesi
result = api_request("/products", {"page": 1, "limit": 10})
products = result["data"]
meta = result["meta"]
print(f"Toplam {meta['total']} urun, sayfa {meta['page']}/{meta['totalPages']}")

for product in products:
    print(f"  {product['name']} - {product['barcode']}")


# Urun detayi
detail = api_request("/products/f47ac10b-58cc-4372-a567-0e02b2c3d479")
p = detail["data"]
print(f"Urun: {p['name']}, Boyut: {p['width']}x{p['height']}x{p['depth']} cm")


# Sube listesi (sehir filtresi)
branches = api_request("/branches", {"city": "Istanbul", "page": 1, "limit": 20})
for branch in branches["data"]:
    print(f"  {branch['name']} ({branch['code']}) - {branch['city']}")


# Tum sayfalari cek
def fetch_all_products() -> list[dict]:
    """Tum urunleri sayfa sayfa ceker."""
    all_products = []
    page = 1

    while True:
        result = api_request("/products", {"page": page, "limit": 100})
        all_products.extend(result["data"])
        if page >= result["meta"]["totalPages"]:
            break
        page += 1

    return all_products


# Webhook imza dogrulama
import hashlib
import hmac


def verify_webhook(payload: bytes, signature: str, secret: str) -> bool:
    """Webhook HMAC-SHA256 imzasini dogrula."""
    expected = hmac.new(secret.encode(), payload, hashlib.sha256).hexdigest()
    return hmac.compare_digest(f"sha256={expected}", signature)