REST API Veri Kaynağı Düzenleme

Bu sayfa, Pirivision Port modülünde daha önce eklenmiş bir REST API veri kaynağının Edit aksiyonuyla güncellenmesini anlatır.

API'nin Base URL'i değiştiğinde, kimlik doğrulama token'ı yenilendiğinde, Client Options ayarları revize edildiğinde veya veri kaynağı farklı bir klasöre taşınmak istendiğinde bu akış kullanılır.

Ön Koşul

Port listesinde en az bir REST API veri kaynağı kayıtlı olmalıdır. Henüz eklenmemişse önce REST API Veri Kaynağı Ekleme sayfasına bakın.

1. Port Listesinde Veri Kaynağını Bulun

Sol menüden Port modülüne tıklayın. Düzenlemek istediğiniz REST API veri kaynağını listede bulun.

Listede arama çubuğunu kullanarak veri kaynağı adını veya #etiket ile filtreleme yapabilirsiniz.

2. Edit Butonuna Tıklayın

Veri kaynağı kartının sağ tarafında Edit butonu (kalem ikonu) yer alır.

Edit butonuna tıklayın.

Tip

Kart üzerinde doğrudan Edit butonu görünür. More menüsünden erişim gerekmez.

3. Düzenleme Formu Açılır

Edit tıklandığında form, mevcut değerler önceden dolu şekilde açılır. Bu, yeni REST API veri kaynağı ekleme formuyla aynı ekrandır; fark yalnızca alanlardaki değerlerin dolu gelmesi ve altta Test and Update butonunun bulunmasıdır.

4. Değiştirilebilen Alanlar

Aşağıdaki alanlar düzenlenebilir:

Bölüm	Alan	Zorunlu	Varsayılan	Açıklama
Display Info	Name	Evet	—	Veri kaynağının Pirivision içindeki görünen adı
Display Info	Description	Hayır	—	Kısa açıklama metni
Essential Connection	Base URL	Evet	—	Tüm API isteklerinin ortak taban adresi
Essential Connection	Global Headers	Hayır	—	Tüm isteklere eklenen başlıklar (key-value çiftleri)
Client Options	Timeout	Hayır	`5000`	İstek zaman aşımı süresi (ms)
Client Options	Retries	Hayır	`3`	Başarısız isteklerin yeniden deneme sayısı
Client Options	Proxy	Hayır	—	Proxy sunucu adresi
Client Options	SSL Verify	Hayır	`OFF`	SSL sertifika doğrulaması
Location	Target Folder	Hayır	—	Veri kaynağının Port klasör yapısındaki konumu

Değiştirilemeyen Alan

Alan	Durum
Veri kaynağı tipi	RestAPI olarak sabit kalır; SQL veya MQTT türlerine dönüştürülemez.

Token Yenileme

JWT veya API key tabanlı kimlik doğrulama kullanıyorsanız token süresi dolduğunda Global Headers bölümündeki Authorization değerini yeni token ile güncelleyin.

5. Test and Update Butonu

Tüm alanlar güncellendikten sonra sağ alttaki Test and Update butonuna tıklayın.

Bu işlem iki aşamada çalışır:

Güncellenmiş Base URL'e bir Ping URL isteği gönderilir ve erişilebilirlik test edilir. Form'daki SSL Verify, Timeout, Proxy ve Headers ayarları aynen uygulanır. Detay → Ping URL — Bağlantı Testi.
Test başarılıysa güncellenen değerler kaydedilir.

Formun alt kısmında şu bilgi görünür:

Connection will be saved automatically if the test is successful

Success

Test başarılı olursa güncellenen veri kaynağı Port listesine yönlendirilir. Bağlantıya ait Compass sorgu önbelleği otomatik geçersiz kılınır.

Failure

Test başarısız olursa güncellenmiş bilgiler kaydedilmez. Base URL, SSL Verify ayarı, Global Headers ve ağ erişimini kontrol edin.

6. Sık Karşılaşılan Hatalar

Hata / Belirti	Olası Neden	Çözüm
`a datasource with this name already exists, please choose a different name`	Aynı isimde başka bir veri kaynağı mevcut	Farklı bir Name değeri girin
`you do not have permission to update this datasource or the datasource was not found`	Veri kaynağı başka bir kullanıcıya ait veya silinmiş	Port listesini yenileyin
`user not found`	Oturum süresi dolmuş	Yeniden giriş yapın
`update failed: ...`	Bağlantı test başarısız	Base URL ve ağ erişimini doğrulayın
`401 Unauthorized`	Token veya API key güncel değil	Global Headers'ta Authorization değerini güncelleyin
`Connection refused`	API servisi çalışmıyor	Hedef servisin ayakta olduğunu kontrol edin
SSL sertifika hatası	Sertifika uyumsuzluğu	SSL Verify'ı `OFF` yapın veya sertifikayı doğrulayın
Timeout	Servis yavaş veya ağ gecikmesi	Timeout değerini artırın

7. Sonraki Adım

Veri kaynağı güncellendikten sonra bu kaynağı kullanan Compass HTTP sorgularının hâlâ doğru çalıştığını doğrulayın.

flowchart LR
    A["Port<br/>REST API Düzenlendi"] --> B["Compass<br/>HTTP Sorgu Doğrulama"]
    B --> C["Cartography<br/>Chart / KPI (değişiklik yok)"]

Özet

REST API veri kaynağı düzenleme süreci:

Port modülüne girilir.
Listede REST API veri kaynağı bulunur.
Kart üzerindeki Edit butonuna tıklanır.
Form mevcut değerlerle dolu açılır.
İlgili alanlar güncellenir (Base URL, Global Headers, Client Options vb.).
Test and Update ile bağlantı test edilip kaydedilir.
Compass'ta HTTP sorgusu doğrulaması yapılır.