Demo Talep Et
Ana Sayfa / Modüller / API Entegrasyon

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

Verileriniz Sizin. Kullanın.

89 uç, OpenAPI 3.0 şeması ve destek ekibi. İlk çağrınızı dakikalar içinde yapın.

Demo Talep Et OpenAPI Şeması (Yapay Zekâya Ver)