🔌

API Entegrasyon Desteği

NetEsnaf Verileriniz, İstediğiniz Yerden

Kendi web sitenizde ürünleri göstermek, mobil uygulamanızdan sipariş almak, iş zekası aracınıza fatura akıtmak — tümü NetEsnaf REST API ile mümkün. 8 modülde 89 uç, standart JSON yanıt, JWT token güvenliği ve makine okunur OpenAPI 3.0 şeması.

Demo Talep Et Uç Noktaları Gör

# 1) Token al curl -X POST https://firmaniz.netesnaf.net/api/v1/auth/login \ -H "Content-Type: application/json" \ -d '{"kullaniciadi":"...","sifre":"..."}' # 2) Son 10 faturayı çek curl "https://firmaniz.netesnaf.net/api/v1/fatura/liste?limit=10" \ -H "Authorization: Bearer <token>" # Yanıt { "status": true, "data": [ { /* fatura kayıtları */ } ], "meta": { "sayfa": 1, "limit": 10, "toplam": 142, "toplam_sayfa": 15 } }

✨ Özellikler

Modern REST API — Standart ve Güvenli

🌐

REST API Mimarisi

HTTP standartlarına uygun, JSON response, GET/POST/PUT/DELETE metodları. Herhangi bir dilden çağrılabilir.

PHP, Python, Node.js, Go, .NET
JSON response (UTF-8)
HTTP status code'ları standart
Sayfalama ve filtreleme

🔑

JWT Token ile Giriş

Kendi ERP kullanıcı adınız ve şifrenizle /auth/login ucundan token alırsınız; sonraki her isteğe Authorization: Bearer başlığıyla eklersiniz.

Ayrı anahtar yönetimi yok
Token süresi dolunca /auth/refresh
HMAC-SHA256 imzalı token
Kullanıcı yetkileri aynen geçerli

🤖

Yapay Zekâya Verin, Kodu O Yazsın

Her firmanın kendi adresinde makine okunur OpenAPI 3.0 şeması yayınlanır. Şemayı bir yapay zekâ asistanına ya da kod üreticiye verip entegrasyonu otomatik yazdırabilirsiniz.

/api/v1/spec/openapi — token gerekmez
Tüm uçlar, parametreler ve tipler dahil
Swagger/Insomnia/Postman'e içe aktarılır
Sürüm değişince şema kendini günceller

📄

Sayfalı ve Tutarlı Yanıt

Tüm liste uçları aynı zarfı döndürür: status, data ve sayfalama bilgisini taşıyan meta. Bir uca yazdığınız kod diğerlerinde de çalışır.

sayfa · limit · toplam · toplam_sayfa
Tarihler YYYY-MM-DD, tutarlar nokta ondalıklı
Arama ve tarih aralığı filtreleri
Hata durumunda açıklayıcı mesaj + HTTP kodu

🔒

Firma Verisi İzole

Token hangi firmaya aitse yalnız o firmanın verisi döner. HTTPS üzerinden çalışır; sağlık kontrolü için ayrı bir uç bulunur.

Her istekte firma izolasyonu
HTTPS
/health/check ile ayakta mı kontrolü
Yetkisiz erişimde 401 / 403

🤖 Yapay Zekâ

Yapay Zekâya NetEsnaf'ı Öğretin

NetEsnaf'ın makine-okunur OpenAPI 3.0 şemasını bir yapay zekâ asistanına (ChatGPT, Claude, Gemini vb.) veya kod üretim aracına verin; entegrasyonunuzu, istemci kodunuzu ve örnek çağrıları dakikalar içinde otomatik kurdurun. Şema tüm uç noktaları, parametreleri ve kimlik doğrulamayı içerir.

OpenAPI Şemasını Aç → Yapay Zekâya Ver

Açılan JSON'u kopyalayıp yapay zekâ asistanınıza yapıştırın: "Bu OpenAPI şemasına göre NetEsnaf entegrasyonu kur." (Şema örnek olarak netesnaf.net üzerinden sunulur; kendi çağrılarınızı kendi NetEsnaf adresinize yaparsınız.)

🔌 Uç Noktalar

8 Modülde 89 Uç

Listeleme, detay, kaydetme ve silme uçları. Aşağıda her modülden birkaç örnek — tam liste OpenAPI şemasındadır.

GETmusteritedarikci/listeCari listesi

GETmusteritedarikci/hareketlerCari ekstresi

GETurunhizmet/bakiyeStok bakiyesi

POSTurunhizmet/fiskaydetStok giriş/çıkış fişi

GETfatura/listeFatura listesi

POSTfatura/kaydetFatura oluştur

GETkasa/listeKasa/banka hareketleri

POSTsipariş/kaydetSipariş oluştur

GETservis/listeServis kayıtları

GETpersonel/listePersonel listesi

POSTtakvim/ekleTakvime etkinlik yaz

GEThealth/checkServis ayakta mı

💡 Kullanım

API Ne İçin Kullanılır?

🌐

Kendi Web Siteniz

Web sitenizde ürün kataloğunu, stok durumunu canlı gösterin. Müşteriler sitenizden sipariş versin, NetEsnaf'ta fatura otomatik kesilsin.

📱

Mobil Uygulama

iOS/Android uygulamanız NetEsnaf verilerini kullansın. Müşteri bakiyesi, sipariş takibi, anlık bildirim.

🏪

Kurumsal Müşterilere Özel Panel

Kurumsal müşterilerinize özel tasarlanmış panel — sadece ilgili verilere erişim, brand'inize uygun arayüz.

📊

İş Zekası (BI)

Power BI, Tableau, Metabase gibi BI araçlarına NetEsnaf verilerini akıtın. Özel dashboard'lar kurun.

🔗

Üçüncü Parti Entegrasyon

Muhasebe programı, lojistik sistemi, CRM — NetEsnaf ile iki yönlü veri akışı.

🤖

Otomasyon / Chatbot

WhatsApp bot'u "bakiyemi göster" komutuna cevap versin. n8n, Zapier, Make ile akış tasarla.

🛡️ Güvenlik

Kurumsal Güvenlik

🔐

Token Tabanlı Erişim

API'ye kendi ERP kullanıcınızla girersiniz; token o kullanıcının yetkileriyle sınırlıdır ve süresi dolduğunda geçersiz olur.

HTTPS üzerinden iletişim
HMAC-SHA256 imzalı JWT
Süre dolunca yenileme zorunlu
Firma verisi çapraz erişime kapalı

📖

Dokümantasyon ve Destek

Panel içinde uç noktaların HTML kılavuzu, dışarıda makine okunur OpenAPI şeması. Entegrasyon sürecinde destek ekibimiz yanınızda.

Panelde API kılavuzu ekranı
OpenAPI 3.0 şeması (canlı üretilir)
Sürümlü uçlar (/api/v1)
Destek ekibi entegrasyon desteği