Entegrasyonlar ve Dış Bağlantı (API)

Dış bağlantı (API) ve webhook yalnız ücretli planda açılır ve yalnız firma hesabının sahibi tarafından yönetilir. Ücretsiz denemede ekran görünür ama anahtar üretilemez.

Anahtar nasıl alınır

Uygulamada Hesabım → Entegrasyonlar ekranını açın.
Anahtara bir ad verin (ör. "ERP bağlantısı") ve yalnız gereken yetkileri işaretleyin.
Anahtar oluştur deyin. Anahtar yalnız bir kez gösterilir; kopyalayıp yazılımınızın gizli ayarlarına kaydedin. Bizde yalnız geri döndürülemez özeti saklanır.
Kaybederseniz aynı ekrandan iptal edip yenisini oluşturun. İptal edilen anahtarla gelen istek hemen reddedilir.

Bağlantı bilgisi

Konu	Değer
Adres	`https://app.elektrikprojecizimi.com/api/v1/dis`
Kimlik	`Authorization: Bearer sok_…` ya da `X-API-Key: sok_…`
Belge (OpenAPI 3.0.3)	`https://app.elektrikprojecizimi.com/api/v1/dis/openapi.json`
Sınır	Anahtar başına dakikada 60 istek; aşılırsa 429 ve `Retry-After`
Yanıt	JSON, UTF-8; hata gövdesi `{"error": "…"}`

Yetkiler

Yetki	Ne yapar
`projeler:oku`	Projeleri okur
`kesif:oku`	Keşif işlerini, durumlarını ve keşif satırlarını okur
`teklif:oku`	Teklifleri, kalemleri ve 3 seviyeyi okur
`ekip:oku`	Puantaj ve ekipman özetini okur
`kesif:yaz`	Projeye dosya yükler ve keşif başlatır (başka yazma yoktur)

Anahtar, onu oluşturan hesabın yetkisiyle çalışır: yalnız kendi firmanızın verisi görünür; hesap pasife alınır ya da plan biterse anahtar da çalışmaz.

Uçlar

Yöntem	Yol	Yetki	Açıklama
`GET`	`/ben`	`herhangi`	Anahtarın firması, yetkileri ve dakika sınırı
`GET`	`/projeler`	`projeler:oku`	Firmanın projeleri (kimlik, ad, adres, durum)
`GET`	`/projeler/{id}`	`projeler:oku`	Tek proje
`GET`	`/projeler/{id}/kesif-isleri`	`kesif:oku`	Projenin keşif işleri ve durumları
`GET`	`/kesif-isleri/{id}`	`kesif:oku`	Keşif işi durumu, ilerleme, çıktı listesi
`GET`	`/kesif-isleri/{id}/satirlar`	`kesif:oku`	Keşif satırları: poz, tanım, miktar, birim, durum, kaynak
`GET`	`/teklifler`	`teklif:oku`	Teklif listesi (durum, seçilen seviye)
`GET`	`/teklifler/{id}`	`teklif:oku`	Teklif kalemleri, toplamlar ve 3 seviye
`GET`	`/ekip/puantaj?ay=YYYY-AA`	`ekip:oku`	Aylık puantaj özeti
`GET`	`/ekip/ekipman`	`ekip:oku`	Ekipman, bakım ve araç özeti
`POST`	`/projeler/{id}/dosyalar`	`kesif:yaz`	Projeye dosya yükleme (multipart, alan adı file)
`POST`	`/projeler/{id}/kesif`	`kesif:yaz`	Keşif başlatma ({dosya_idleri:[…]} ya da {tumu:true}) — yanıt 202 + iş kimliği

Örnek:

curl -H "Authorization: Bearer sok_ANAHTARINIZ" https://app.elektrikprojecizimi.com/api/v1/dis/projeler

Webhook (olay bildirimi)

Entegrasyonlar ekranında adres (https://) ve olay seçersiniz; size bir imza anahtarı (whsec_…) bir kez gösterilir.

Olay	Ne zaman
`kesif.tamamlandi`	Keşif işi tamamlandı ya da kısmi tamamlandı
`teklif.onaylandi`	Teklif durumu Kazanıldı oldu (müşteri 3 seviyeden birini seçtiğinde de)

Gövde: {"olay": "kesif.tamamlandi", "teslim_id": "…", "zaman": "…", "veri": {…}}. Başlıklar: X-SahaOps-Olay ve X-SahaOps-Imza: t=<unix>,v1=<hex>. İmza, t + "." + ham gövde metninin imza anahtarıyla HMAC-SHA256 değeridir; 5 dakikadan eski imzayı reddedin.

// Node.js
const crypto = require("crypto");
function dogrula(gizli, govde, baslik) {
  const [, t, v1] = /^t=(\d+),v1=([0-9a-f]{64})$/.exec(baslik) || [];
  if (!t || Math.abs(Date.now() / 1000 - Number(t)) > 300) return false;
  const bek = crypto.createHmac("sha256", gizli).update(t + "." + govde).digest("hex");
  return crypto.timingSafeEqual(Buffer.from(bek), Buffer.from(v1));
}

Teslim edilemeyen bildirim 1 dk, 5 dk, 30 dk ve 2 saat sonra yeniden denenir. Art arda 20 başarısız teslimde webhook kapanır; ekrandan yeniden açarsınız. Yerel ya da özel ağ adreslerine bildirim gönderilmez.

Hazır dışa aktarımlar

Keşif & metraj: Excel; İncele satırları JSON / CSV
Çizim paftaları: DXF ve PDF
BIM modeli: IFC4
Teklif: Kapsam CSV, 3 seviyeli teklif yazdır / PDF
Puantaj: Excel ve PDF çizelge
Yönetmelik raporu: IEC ya da NEC hesabı Excel

Güvenlik ve kişisel veri

Anahtarın kendisi saklanmaz; yalnız geri döndürülemez özeti tutulur. Webhook imza anahtarı yalnız oluşturulurken gösterilir.
Kullanım günlüğünde zaman, yöntem, uç, sonuç kodu ve süre 90 gün tutulur; IP adresi ve istek içeriği kaydedilmez.
Verinin kendi sisteminize aktarılmasına firmanız karar verir; bu aktarımda veri sorumlusu firmanızdır. Ayrıntı: Güven Merkezi.

Muhasebe programlarına (Logo, Mikro, Paraşüt vb.) hazır bağlantı bu sürümde yoktur; yukarıdaki uçlarla kendi aktarımınızı kurabilirsiniz.

Entegrasyonlar ve dış bağlantı