Entegrasyona Hoş Geldiniz

Bu portal, FriSay (FShop) e-ticaret platformunu entegre etmek, Web API ile ürün/sipariş senkronize etmek, vitrin AJAX uçlarını kullanmak ve modül / tema geliştirmek için dokümantasyon sağlar.

Nereden başlamalı?

  1. Hızlı Başlangıç — uçtan uca partner entegrasyon akışı
  2. API Kuralları — sayfalama, hatalar, rate limit
  3. Kimlik Doğrulama — API anahtarı ve izinler
  4. Endpoint sayfaları — ürünler, katalog, siparişler
  5. Modül / Tema — platformu genişletme

Nasıl kullanılır?

  1. FriSay yönetim panelinde API bölümüne gidin.
  2. Web API özelliğini etkinleştirin ve bir anahtar oluşturun (izinleri iş ortağına göre ayarlayın).
  3. Her istekte anahtarı X-API-Key başlığıyla gönderin.
  4. PHP ve cURL örnekleri için ilgili endpoint sayfalarını takip edin.

Temel URL

OrtamURL
Canlıhttps://yoursite.com/api/v1/
Yerelhttp://localhost/fshop/api/v1/

Bu portalda neler var?

Bölümİçerik
BaşlangıçHızlı başlangıç, kurallar, kimlik doğrulama
Ürünler / Katalog / SiparişlerPartner Web API (/api/v1)
Vitrin ve OperasyonTema AJAX API, cron / döviz / pazaryeri
GeliştiricilerModül, ödeme modülü, hook, sabitler, tema

Genel Bilgiler

  • Canlı ortamda HTTPS tercih edin.
  • İstek / yanıt formatı JSON (UTF-8) şeklindedir.
  • POST/PATCH isteklerinde Content-Type: application/json gönderin.
  • API sürümü: v1
  • Ürün sayfası 1 tabanlı; sipariş sayfası 0 tabanlıdır — ayrıntılar için API Kuralları.

HTTP Durum Kodları

KodAnlam
200Başarılı
201Oluşturuldu (ör. yeni ürün / görsel)
400Geçersiz istek
403API kapalı veya geçersiz anahtar
404Kayıt bulunamadı
422Doğrulama hatası
429Rate limit aşıldı
503API anahtarı yapılandırılmamış

Test Sitesi

https://fyazilim.com/fshop/admin

User: admin@fyazilim.com

Pass: admin123

API Key: Admin → API

İpucu: Her iş ortağı için ayrı API anahtarı ve sınırlı izinler tanımlayın (ör. yalnızca sipariş okuma vs tam ürün yetkisi). Detaylı akış için Hızlı Başlangıç sayfasına bakın.