# REST API ve Webhook Entegrasyonları

> REST API ile demirbaş ve iş emri verisini okuyun, arıza açın; imzalı webhook ile olayları anlık alın.

Entak diğer sistemlerle veri alışverişi için REST API ve webhook sunar. API anahtarları işletme bazında üretilir ve okuma veya yazma kapsamıyla sınırlanır; webhook'lar seçilen olayları imzalı olarak belirlediğiniz adrese iletir.

## 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.

İlgili özellikler: [Güvenlik ve KVKK](https://entak.com.tr/ozellikler/guvenlik-ve-kvkk), [İş Emri ve SLA](https://entak.com.tr/ozellikler/is-emri-ve-sla-yonetimi), [Demirbaş ve Envanter](https://entak.com.tr/ozellikler/demirbas-envanter-yonetimi), [Mobil Uygulama (PWA)](https://entak.com.tr/ozellikler/mobil-uygulama-ve-qr-okutma)

Kaynak: https://entak.com.tr/ozellikler/api-ve-entegrasyonlar · Son güncelleme: 2026-09-27