REST API
REST API, Pirivision'ın Port modülünde desteklenen, HTTP/HTTPS protokolü üzerinden web servislerine bağlanan veri kaynağı tipidir.
Veritabanına doğrudan erişim yerine JSON veya XML döndüren bir API endpoint'i aracılığıyla veri sağlayan ERP, MES, bulut platformları ve üçüncü taraf sistemlere bağlanmak için idealdir.
Güçlü Yanları
| Özellik | Açıklama |
|---|---|
| Evrensel Erişim | HTTP/HTTPS destekleyen her servise bağlanma imkânı |
| Veritabanısız Entegrasyon | Doğrudan DB erişimi olmayan sistemlere API katmanı üzerinden erişim |
| Bulut Servis Uyumu | AWS, Azure, Google Cloud ve SaaS platformlarıyla uyum |
| Auth Esnekliği | Bearer token, API Key, Basic Auth gibi tüm yaygın auth mekanizmaları |
| Global Headers | Tüm sorgulara otomatik eklenen kimlik doğrulama başlıkları |
| Timeout & Retry | Geçici servis hatalarına karşı otomatik yeniden deneme |
| SSL Yapılandırması | Self-signed sertifikalı iç servisler için SSL doğrulama kontrolü |
Pirivision'da Yapılabilecekler
| İşlem | Açıklama |
|---|---|
| GET Sorgusu | Endpoint'ten JSON veri çekme |
| POST Sorgusu | Body ile veri göndererek yanıt alma |
| Dynamic Path | Base URL üzerine farklı path'ler ekleyerek çoklu endpoint sorgusu |
| Header Yönetimi | Authorization, API Key başlıklarını global veya sorgu bazında tanımlama |
| JSON Parse | Dönen JSON içindeki alanları Cartography'ye aktarma |
| Ping Testi | Base URL erişilebilirliğini bağlantı kurmadan doğrulama |
Hangi Durumlarda Kullanılır?
- Bulut ERP / MES: SAP API Hub, Oracle Fusion veya bulut tabanlı MES REST endpoint'i
- SaaS Platformları: Üretim takip, bakım yönetimi veya kalite SaaS uygulamaları
- OPC Köprüsü: OPC-UA / Modbus → REST API dönüştürücü gateway'ler
- IoT Platform API'leri: AWS IoT, Azure IoT Hub veya Thingsboard REST API'leri
- Dahili Mikroservisler: Şirket içi API gateway veya microservice mimarisinden veri alma
Bağlantı Gereksinimleri
| Bilgi | Zorunlu | Varsayılan |
|---|---|---|
| Base URL | Evet | — |
| Global Headers | Hayır | — |
| Timeout | Hayır | 5000 ms |
| Retries | Hayır | 3 |
| Proxy | Hayır | — |
| SSL Verify | Hayır | OFF |
Base URL
Base URL yalnızca kök adresi içermelidir (https://api.example.com). Spesifik path'ler Compass'ta eklenir.
Rehberler
| Rehber | Açıklama |
|---|---|
| REST API Veri Kaynağı Ekleme | Port modülünde yeni REST API bağlantısı oluşturma |
| REST API Veri Kaynağı Düzenleme | Mevcut bağlantıyı güncelleme |
| Veri Kaynağı Taşıma | Farklı klasöre taşıma |
| Veri Kaynağı Çoğaltma | Aynı ayarlarla kopyalama |
| Veri Kaynağı Silme | Veri kaynağını kaldırma |