CEPASS API: ERP ve entegrasyonlar

Authorization: Bearer cpk_1a2b3c4d_…

curl -s "$CEPASS_URL/api/v1/durum" \
  -H "Authorization: Bearer $CEPASS_ANAHTAR"

{
  "veri": {
    "surum": "v1",
    "zaman": "2026-11-05T09:00:00.000Z",
    "kurum": "Örnek Makina A.Ş. (kurgusal)",
    "demo": true,
    "sonOlayId": 40,
    "anahtar": {
      "id": "AK-01",
      "ad": "ERP bağlantısı",
      "onek": "cpk_1a2b3c4d",
      "kapsamlar": [
        "urun:oku",
        "urun:yaz",
        "beyan:oku",
        "olay:oku"
      ],
      "bitis": "2027-02-03T09:00:00.000Z"
    }
  }
}

curl -s "$CEPASS_URL/api/v1/urunler?urunKodu=PH-200" \
  -H "Authorization: Bearer $CEPASS_ANAHTAR"

{
  "veriler": [
    {
      "id": "PRJ-2026-001",
      "urunKodu": "PH-200",
      "ad": "Konveyörlü paletleme hücresi PH-200",
      "model": "PH-200",
      "tip": "Robotlu",
      "urunTuru": "makine",
      "urunTuruAd": "Makine",
      "ce": {
        "beyanDurumu": "taslak",
        "beyanTuru": "uygunluk",
        "beyanSurumu": 1,
        "piyasayaHazir": false,
        "dogrulamaKodu": null,
        "teknikDosyaTamlik": 20,
        "toplamRisk": 10,
        "acikRisk": 5,
        "eskimisStandart": 1,
        "rehberYuzde": 13,
        "engelSayisi": 4
      },
      "olusturuldu": "2026-10-29T09:00:00.000Z",
      "guncellendi": "2026-10-29T09:00:00.000Z",
      "panelAdresi": "https://cepass-adresiniz/panel/#/proje/PRJ-2026-001"
    }
  ],
  "sayfa": 1,
  "adet": 25,
  "toplam": 1,
  "sonrakiSayfa": null
}

curl -s -X POST "$CEPASS_URL/api/v1/urunler" \
  -H "Authorization: Bearer $CEPASS_ANAHTAR" \
  -H "Content-Type: application/json" \
  -d '{"urunKodu":"KNV-310","ad":"Bantlı konveyör KNV-310","urunTuru":"makine","model":"KNV-310"}'

{
  "veri": {
    "id": "PRJ-2026-005",
    "urunKodu": "KNV-310",
    "ad": "Bantlı konveyör KNV-310",
    "model": "KNV-310",
    "tip": null,
    "urunTuru": "makine",
    "urunTuruAd": "Makine",
    "ce": {
      "beyanDurumu": "taslak",
      "beyanTuru": "uygunluk",
      "beyanSurumu": 1,
      "piyasayaHazir": false,
      "dogrulamaKodu": null,
      "teknikDosyaTamlik": 0,
      "toplamRisk": 0,
      "acikRisk": 0,
      "eskimisStandart": 0,
      "rehberYuzde": 0,
      "engelSayisi": 4
    },
    "olusturuldu": "2026-11-05T09:30:00.000Z",
    "guncellendi": "2026-11-05T09:30:00.000Z",
    "panelAdresi": "https://cepass-adresiniz/panel/#/proje/PRJ-2026-005"
  }
}

{
  "error": "Bu ürün kodu başka bir üründe kayıtlı.",
  "mevcut": {
    "id": "PRJ-2026-005"
  }
}

curl -s -X PATCH "$CEPASS_URL/api/v1/urunler/PRJ-2026-005" \
  -H "Authorization: Bearer $CEPASS_ANAHTAR" \
  -H "Content-Type: application/json" \
  -d '{"seriNo":"KNV-310-0001…0050","teknik":{"guc":"5,5 kW","besleme":"3~ 400 V, 50 Hz"}}'

{
  "veri": { "id": "PRJ-2026-005", "urunKodu": "KNV-310", "ce": { … } },
  "degisenler": ["seriNo", "teknik"]
}

curl -s "$CEPASS_URL/api/v1/olaylar?sonra=40&adet=50" \
  -H "Authorization: Bearer $CEPASS_ANAHTAR"

{
  "veriler": [
    {
      "id": 41,
      "tur": "uyum.degisti",
      "zaman": "2026-11-05T10:12:00.000Z",
      "veri": {
        "urunId": "PRJ-2026-004",
        "urunKodu": "KP-3",
        "ad": "Kumanda panosu KP-3",
        "degisenler": [
          "beyanDurumu",
          "piyasayaHazir",
          "dogrulamaKodu"
        ],
        "onceki": {
          "beyanDurumu": "onay-bekliyor",
          "piyasayaHazir": false,
          "dogrulamaKodu": null
        },
        "ce": {
          "beyanDurumu": "onayli",
          "beyanTuru": "uygunluk",
          "beyanSurumu": 1,
          "piyasayaHazir": true,
          "dogrulamaKodu": "CEP-F2CD-3036-83CD-F106",
          "teknikDosyaTamlik": 100,
          "toplamRisk": 2,
          "acikRisk": 0,
          "eskimisStandart": 0,
          "rehberYuzde": 100,
          "engelSayisi": 0
        }
      }
    },
    {
      "id": 42,
      "tur": "beyan.onaylandi",
      "zaman": "2026-11-05T10:12:00.000Z",
      "veri": {
        "urunId": "PRJ-2026-004",
        "urunKodu": "KP-3",
        "ad": "Kumanda panosu KP-3",
        "beyanTuru": "uygunluk",
        "beyanSurumu": 1,
        "dogrulamaKodu": "CEP-F2CD-3036-83CD-F106"
      }
    }
  ],
  "sonOlayId": 42,
  "dahaVar": false,
  "enEskiOlayId": 1
}

{
  "error": "Lütfen işaretli alanları kontrol edin.",
  "fields": {
    "urunTuru": "Geçerli değerler: makine, …"
  }
}

{"id":42,"tur":"beyan.onaylandi","zaman":"2026-11-05T10:12:00.000Z","surum":"v1","veri":{"urunId":"PRJ-2026-004","urunKodu":"KP-3","ad":"Kumanda panosu KP-3","beyanTuru":"uygunluk","beyanSurumu":1,"dogrulamaKodu":"CEP-F2CD-3036-83CD-F106"}}

X-CEPASS-Imza: t=1793873520,v1=8924cd8906c69d079914737a1810de46f5e114d3506a92adf5154b5fbcd75fbf

const { createHmac, timingSafeEqual } = require('node:crypto');

// gizli: panelde webhook eklerken bir kez gösterilen whsec_… değeri
// baslik: X-CEPASS-Imza başlığı · govde: isteğin HAM gövdesi (JSON.parse öncesi metin)
function imzaGecerli(gizli, baslik, govde, toleransSn = 300) {
  const p = Object.fromEntries(String(baslik).split(',').map((x) => x.split('=').map((y) => y.trim())));
  const t = Number(p.t);
  if (!Number.isInteger(t) || !/^[0-9a-f]{64}$/.test(p.v1 || '')) return false;
  if (Math.abs(Math.floor(Date.now() / 1000) - t) > toleransSn) return false;
  const beklenen = createHmac('sha256', gizli).update(`${t}.${govde}`).digest('hex');
  return timingSafeEqual(Buffer.from(p.v1), Buffer.from(beklenen));
}