REST API v1
| Uç nokta | İşlev |
|---|---|
| GET /api/v1/assets | Demirbaş listesi; arama ve sayfalama (sayfa başına en fazla 200) |
| GET /api/v1/assets/{id} | Tek demirbaşın ayrıntıları |
| GET /api/v1/assets/{id}/qr | Demirbaşın QR bilgi sayfası adresi |
| GET /api/v1/work-orders | İş emirleri; durum filtresiyle (açık, atanmamış, SLA aşıldı, beklemede, tamamlanan, iptal) |
| POST /api/v1/faults | Arıza kaydı açma (yazma kapsamı gerekir) |
Kimlik doğrulama “Authorization: Bearer” başlığıyla yapılır. Anahtar yalnızca üretildiği anda bir kez gösterilir; sistemde yalnızca özeti saklanır. Yanıtlar JSON biçimindedir.
Webhook
- Olaylar: demirbaş oluşturuldu, iş emri durumu değişti, arıza oluşturuldu
- JSON gövde; X-Entak-Event ve X-Entak-Signature (HMAC-SHA256) başlıklarıyla imzalı
- Hedef adres yalnızca https olabilir; iç ağ ve yerel adresler reddedilir, yönlendirmeler izlenmez
- Teslim ana işlemi bekletmez; 5 saniye zaman aşımıyla arka planda gönderilir
Kullanım örnekleri
- Otel yönetim sisteminden veya çağrı merkezinden gelen talepleri arıza kaydına dönüştürmek
- Demirbaş listesini BI ve raporlama araçlarına aktarmak
- İş emri durum değişikliklerini ekip ve mesajlaşma araçlarına iletmek
- Yeni demirbaş kayıtlarını kendi yazılımlarınıza bildirmek
Sık sorulan sorular
API anahtarını kimler oluşturabilir?
API anahtarları işletme ayarlarındaki API sekmesinden işletme yöneticisi (ve yetkisi açık grup yöneticisi) tarafından üretilir. Her anahtar okuma veya yazma kapsamıyla ve yalnızca kendi işletmesinin verisiyle sınırlıdır.
Webhook isteğinin Entak'tan geldiği nasıl doğrulanır?
Her istek, X-Entak-Signature başlığında gövdenin paylaşılan gizli anahtarla hesaplanmış HMAC-SHA256 imzasını taşır. Aynı imza alıcı tarafta hesaplanarak istek doğrulanır.
ERP veya muhasebe yazılımıyla hazır entegrasyon var mı?
Hazır bir ERP veya muhasebe bağlayıcısı bulunmaz; REST API ve webhook ile kendi sistemlerinize özel entegrasyon kurulur.