ApivomApivom
Demo Alın

Penta REST API Bağlayıcısı

Penta Teknoloji'nin apirest.penta.com.tr adresindeki REST API'si — ürün listeleri, sipariş oluşturma ve sorgulama, merkez depo (2890) stoğu, siparişleri ve teslimatları, ESD lisans bilgileri, garanti ve teknik servis sorguları — bayi kimlik bilgilerinizle ve Iris'in kendisinin aldığı 12 saatlik jetonla Apivom Iris'e bağlı.

Neler yapabilirsiniz

  • Sipariş oluşturun ve durumunu sorgulayın; bayiye açık ürünleri listeleyin
  • Merkez depo (2890): ürün bulunabilirliği, sipariş oluşturma ve teslimat takibi
  • Elektronik teslim edilen yazılımlar için ESD lisans bilgileri
  • Bir seri numarası veya ürün için garanti sorgusu ve teknik servis sorgusu
  • 12 saatlik Bearer jetonu Iris tarafından /api/Auth/RequestToken üzerinden alınır ve önbelleğe alınır; ayrı test sunucusu (apiresttst.penta.com.tr)
  • 9 kataloglanmış rota, Iris entegrasyon merkezinden onay arkasında çalıştırılabilir

Kullanım senaryoları

  • İlk aramada garanti yanıtı — Müşteri telefondayken seri numarası için garanti ve teknik servis sorgularını Iris kaydından çalıştırın.
  • Teslimat takipli merkez depo siparişi — Bir anlaşmadaki kalemler için 2890 stoğunu kontrol edin, depo siparişini oluşturun ve teslimat durumunu aynı fırsattan izleyin.
  • Sattığınız yazılımın lisans anahtarları — Elektronik teslim edilen bir ürün için ESD lisans bilgisini çekin ve müşterinin satın alma geçmişiyle birlikte saklayın.

Penta Teknoloji REST API, Base API ve SOAP web servisinin yanında duran daha hafif, JSON tabanlı bayi servisidir. Dokuz işlemi bir bayinin distribütörüne sorduğu günlük soruları kapsar: hangi ürünleri alabilirim, merkez depoda (Penta'nın 2890 lokasyonu) var mı, orada sipariş oluşturup teslimatını izleyeyim, sattığım bir ESD ürününün lisans bilgisi nedir ve bu seri hâlâ garantide mi ya da teknik servise uygun mu. Apivom Iris bayinin müşteri kodu, kullanıcı adı ve şifresiyle bağlanır; Penta /api/Auth/RequestToken üzerinden 12 saatlik bir jeton verir, Iris bunu doğrudan Penta'dan ister, önbelleğe alır ve Apivom Atlas üzerinden iletilen her çağrıya Bearer başlığı olarak ekler — şifre kiracınızdan hiç çıkmaz ve jeton rotaları bilinçli olarak katalog dışındadır. Tüm rotalar POST işlemidir; bu nedenle Iris entegrasyon merkezinden onay arkasında çalışır, istek ve yanıt kiracınızda kaydedilir. Penta'nın test sunucusu yeni bir bayinin tüm akışı üretimden önce doğrulamasını sağlar.

Kimlik doğrulama

Bayi kodu (müşteri) + kullanıcı adı + şifre. Iris Penta'nın /api/Auth/RequestToken uç noktasını doğrudan çağırır, 12 saatlik jetonu önbelleğe alır ve her istekte Bearer olarak gönderir; jeton rotaları bilinçli olarak kayıtlı değildir. Şifre Iris kiracınızda şifreli kalır; Atlas hiçbir şey saklamaz.

Sık sorulan sorular

Neden üç Penta bağlayıcısı var?

Penta farklı kapsam ve protokollerde üç servis sunar: Dijital mikroservisi (katalog, standart siparişler, abonelikler), Base API (üretim siparişleri) ve bu REST API (merkez depo siparişleri, lisanslar, garanti). Kimlik bilgisi, sunucu ve rotalar tam kalsın diye her biri ayrı kaydedilir.

Jeton nasıl yenilenir?

Önbellekteki jetonun süresi dolunca Iris, kiracınızda şifreli saklanan bayi kimlik bilgileriyle Penta'nın /api/Auth/RequestToken uç noktasından yeni bir 12 saatlik jeton ister. Apivom Atlas yalnızca ortaya çıkan Bearer başlığını iletir.

Apivom bu bağlayıcı için API çağrısı başına ücret alır mı?

Hayır. Bağlayıcılar Apivom kiracınızın parçasıdır ve Atlas portalında ölçümlenmez. Bağladığınız hesapta sağlayıcının kendi fiyatlandırması, kotaları ve hız sınırları geçerli olmaya devam eder — Apivom çağrılarını bu sınırların içinde kalacak şekilde hızlandırır ve her çağrıyı kiracınızın entegrasyon günlüğünde gösterir.

Kimlik bilgilerim nerede saklanır, trafiği kim görür?

Apivom Atlas durumsuz bir geçittir: sağlayıcı kimlik bilgilerini veya jetonları asla saklamaz. Bağlanan Apivom ürünü kimlik bilgisini kiracı veritabanınızda şifreli tutar; her istek ve yanıt yalnızca kiracınızda kaydedilir — verileriniz kiracılar arasında asla paylaşılmaz.

Diğer Atlas entegrasyonları

AI entegrasyon rehberi (llms.txt)

Makine tarafından okunabilir markdown — AI asistanınıza entegrasyon talimatı olarak verin.