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ı?
- Hızlı Başlangıç — uçtan uca partner entegrasyon akışı
- API Kuralları — sayfalama, hatalar, rate limit
- Kimlik Doğrulama — API anahtarı ve izinler
- Endpoint sayfaları — ürünler, katalog, siparişler
- Modül / Tema — platformu genişletme
Nasıl kullanılır?
- FriSay yönetim panelinde API bölümüne gidin.
- Web API özelliğini etkinleştirin ve bir anahtar oluşturun (izinleri iş ortağına göre ayarlayın).
- Her istekte anahtarı
X-API-Keybaşlığıyla gönderin. - PHP ve cURL örnekleri için ilgili endpoint sayfalarını takip edin.
Temel URL
| Ortam | URL |
|---|---|
| Canlı | https://yoursite.com/api/v1/ |
| Yerel | http://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şler | Partner Web API (/api/v1) |
| Vitrin ve Operasyon | Tema AJAX API, cron / döviz / pazaryeri |
| Geliştiriciler | Modü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/jsongö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ı
| Kod | Anlam |
|---|---|
200 | Başarılı |
201 | Oluşturuldu (ör. yeni ürün / görsel) |
400 | Geçersiz istek |
403 | API kapalı veya geçersiz anahtar |
404 | Kayıt bulunamadı |
422 | Doğrulama hatası |
429 | Rate limit aşıldı |
503 | API 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.