REST API Endpointleri
REST API endpoint tanımları, Compass modülünde REST API veri kaynaklarına yapılan HTTP isteklerini Compass kaydı olarak saklar.
Port modülünde eklenmiş bir REST API veri kaynağı seçilerek Compass'ta REST tanımlama formu açılır. Endpoint path, HTTP metodu, query parametreleri ve isteğe özel başlıklar yapılandırılır; istek test edildikten sonra kaydedilir.
Adlandırma
REST API için Compass'ta sorgu yazılmaz — bunun yerine Base URL üzerine bir endpoint tanımlanır (path + metot + parametreler). Bu nedenle bu modülün eylem adı "Endpoint Tanımlama" / "Endpoint Düzenleme" olarak geçer.
Demo Fabrika — REST mock endpoint'leri
Demo Fabrika REST akışı şu mock endpoint'leri sunar (Port'ta Demo Fabrika - REST adıyla kayıtlı):
| Endpoint | Yanıt | Açıklama |
|---|---|---|
GET /api/oee/today |
tek nesne | Günlük OEE özeti |
GET /api/sayac/anlik |
tek nesne | Anlık üretim sayacı |
GET /api/sicaklik/trend?hat={{hat_id}}&hours={{hours}} |
array (~289) | 5 dk granüler sıcaklık trendi |
GET /api/vardiya/dun |
array (3) | Dünkü vardiya üretim toplamları |
GET /api/durus/dagilim?gun={{day}} |
array (5) | 7 günlük duruş tipi dağılımı |
GET /api/alarm/son50 |
array (50) | Son 50 alarm |
GET /api/recete?makine={{makine_id}} |
array (8 / 4) | Reçete parametre listesi |
Port'taki veri kaynağı adı: Demo Fabrika - REST.
Aynı endpoint'leri kendi ortamınızda başlatmak için → Sentetik Veri Üretimi — REST API
Güçlü Yanları
| Özellik | Açıklama |
|---|---|
| Evrensel Uyumluluk | HTTP destekleyen her servis ile çalışır: ERP, MES, CMMS, bulut API'leri |
| Dinamik Path'ler | Port'taki Base URL sabit tutulurken her tanıma özel endpoint path eklenebilir |
| Parametreli İstekler | Query string parametreleri dashboard filtreleriyle bağlanabilir |
| Özel Başlıklar | Endpoint bazında özel HTTP header tanımlama (Port global başlıklara ek) |
| GET / POST Desteği | Veri çekme (GET) ve gönderme (POST) işlemleri |
| JSON / XML Önizleme | Yanıt verisi editörde syntax-highlighted önizleme ile görüntülenebilir |
Pirivision'da Yapılabilecekler
| İşlem | Örnek Senaryo |
|---|---|
| ERP KPI | SAP veya Oracle ERP'den günlük üretim hedefi çekme |
| Hava Durumu | Tesis lokasyonuna göre ortam koşulları izleme |
| Dış Servis Entegrasyonu | CMMS sisteminden açık bakım emri sayısı |
| Periyodik Rapor | Vardiya raporlarını REST API üzerinden çekerek dashboard'da gösterme |
| Kimlik Doğrulama | Bearer token veya API key ile korunan endpoint'lere erişim |
Gereksinimler
| Gereksinim | Açıklama |
|---|---|
| Port'ta REST API veri kaynağı | Base URL ve varsa global başlıklar eklenmiş olmalı |
| Endpoint bilgisi | Tanımlanacak endpoint path'i ve HTTP metodu bilinmeli |
Rehberler
| Rehber | Açıklama |
|---|---|
| REST Endpoint Tanımlama | Compass'ta REST endpoint tanımlama ve kaydetme |
| REST Endpoint Düzenleme | Mevcut REST endpoint tanımını güncelleme |
| Compass Kaydını Taşıma | Kaydı farklı klasöre taşıma |
| Compass Kaydını Çoğaltma | Aynı kaydı kopyalama |
| Compass Kaydını Silme | Kaydı kaldırma |
Sonraki Adım
REST endpoint kaydedildikten sonra Cartography modülünde bu kaydı kullanan bir chart / KPI widget oluşturulur.