Düzenleme API’si

Nesne, cihaz ve bağlantıları toplu düzenleme isteğiyle oluşturun ve değiştirin.

Son güncelleme: 2026-11-10

Bu sayfada

İstek biçimi İşlem ve varlık türleri Güncelleme ve silme Bağlantı uçları Yerleşim ve güzergâh ilişkisi Yanıtı uygulama

İstek biçimi

POST /api/p/{pid}/edit JSON kabul eder:

{
  "request_id": "ornek-duzenleme-001",
  "note": "Planlanan saha kaydı",
  "ops": [
    {
      "op": "create",
      "entity": "feature",
      "id": "gecici-dolap",
      "type": "cabinet",
      "geometry": {"type": "Point", "coordinates": [32.0, 39.0]},
      "props": {"name": "Dağıtım noktası", "status": "planned"}
    },
    {
      "op": "create",
      "entity": "equipment",
      "id": "gecici-odf",
      "type": "odf",
      "node_id": "gecici-dolap",
      "props": {"ports": 24, "label": "Panel A"}
    }
  ]
}

Bu örnekte önce saha dolabı, sonra aynı istekte bu dolaba bağlı ODF oluşturulur. Koordinatlar örnektir. id alanları istemciye ait geçici başvurulardır; sunucu kalıcı kimlikleri üretir. İşlemler sırayla çalıştığından bir başvuru, kendisinden önce oluşturulan kaydı gösterebilir.

Üst düzey ops 1–2000 öğe, note en fazla 500 karakter alır. request_id kuralları Eşzamanlılık sayfasındadır.

İşlem ve varlık türleri

op değeri create, update veya delete olur. entity verilmezse feature kabul edilir.

`entity`	Kullanım	Oluşturmada temel alanlar
`feature`	Harita nesnesi	`type`, uygun `geometry`; `ref` için `ref_layer_id`
`equipment`	Fiber cihazı	Cihaz `type`, `node_id` veya uygun `parent_id`, türün gerektirdiği `props`
`connection`	Lif/port bağlantısı	`node_id`, `a`, `b`
`relation`	Yerleşim, giriş veya güzergâh	`type`, `child`, `parent`; güzergâhta isteğe bağlı `seq`, `via`, `via_no`
`talep_item`	Adres ve bina plan kayıtları	Alt tür ve ilgili bina/birim alanları
`fiber_item`	Kıl ve tahsis kayıtları	Alt türe özgü alanlar; kurallar özel tahsis akışını gerektirebilir
`circuit`	Teknik devre	`a`, `b` çapaları, `props`; isteğe bağlı `endpoint_id`
`optik_item`	Optik profil, seçim ve ölçüm	Alt türe özgü `props`; hesap oluşturma özel hesap ucundan yapılır

Tablodaki türlerin tamamı aynı serbest CRUD davranışına sahip değildir. Örneğin kaynak birim satırı doğrudan oluşturulamaz; optik hesap güncellenemez. Optik profil ve seçim yazımı yönetici yetkisi ister. Elektrik varlıkları henüz genel kullanıma açık değildir ve bu entegrasyon kapsamına dahil edilmemiştir.

Güncelleme ve silme

Aşağıdaki gövdede kimlik ve sürüm değerlerini son okuduğunuz kayıtla değiştirin:

{
  "request_id": "ornek-duzenleme-002",
  "ops": [
    {
      "op": "update",
      "entity": "feature",
      "id": "DOL-123",
      "version": 1,
      "props": {"status": "existing", "note": null}
    }
  ]
}

Gönderilmeyen öznitelikler korunur; props içindeki açık null değeri ilgili özniteliği kaldırır. Geometriyi değiştirmek için geometry alanı verilir. Konum niteliği quality nesnesinde method, verified, accuracy_m alanlarıyla düzenlenir; izinli seçenekler katalogdan alınır.

Silme örneği:

{
  "request_id": "ornek-duzenleme-003",
  "ops": [
    {"op": "delete", "entity": "feature", "id": "DOL-123", "version": 2}
  ]
}

Silme bağımlı kayıtlara da etki edebilir. İşlemi göndermeden önce nesnenin ayrıntılarını ve ilişkilerini okuyun. Başarılı yanıtın değiştirdiği kayıt kümesini esas alın.

Bağlantı uçları

Bir lif ucu ve ODF’nin arka yüzündeki port aşağıdaki biçimdedir. Başvurulan kablo ve cihaz aynı projede bulunmalı; kablo, bağlantının düğümünde sonlanmalıdır.

{
  "op": "create",
  "entity": "connection",
  "node_id": "DOL-123",
  "a": {"t": "fiber", "cable": "KB-456", "n": 1},
  "b": {"t": "port", "eq": "ODF-789", "side": "in", "n": 1},
  "props": {"kind": "splice"}
}

Bu nesne ops dizisine konur. Port yüzleri in ve out, numaralar 1’den başlar. Bir lif veya port aynı düğümde zaten bağlıysa yeni bağlantı 409 ile reddedilir. Bağlantı uçları genel güncellemede değiştirilemez; mevcut bağlantıyı silip yenisini oluşturun. Kaset yerleşimi için location_id ve slot kullanılır.

Yerleşim ve güzergâh ilişkisi

Aşağıdaki örnek, mevcut bir ek kutusunu mevcut menholün içine yerleştirir. Kimlikleri aynı projedeki gerçek kayıtlarla değiştirin:

{
  "request_id": "ornek-duzenleme-004",
  "ops": [
    {
      "op": "create",
      "entity": "relation",
      "type": "icinde",
      "child": "EK-123",
      "parent": "MH-456"
    }
  ]
}

Çocuk bir nokta kaydı, ebeveyn uygun bir ortak saha yapısı olmalıdır. Çocuğun zaten bir yerleşim ebeveyni varsa önce mevcut ilişki kaldırılmalıdır. Yerleşim döngüsü kurulamaz. İlişki oluşturmak nesneyi geometrik olarak taşımaz.

type: "guzergah" işleminde child kablo veya boruyu, parent kazı/havai hat segmentini gösterir. Boru yalnız kazıdan geçebilir. seq verilmezse ilişki güzergâhın sonuna eklenir. Kabloyu bir borudan geçirmek için via, alt boruyu belirtmek için via_no kullanılır; borunun aynı segmentte kayıtlı güzergâhı bulunmalıdır. type: "giris", adres girişini binaya bağlayan ayrı ilişki türüdür.

Yanıtı uygulama

Başarı yanıtı ok, batch, ids, tmp ve features taşır. İşleme göre equipment, connections, fiber_items, circuits, optik_items ve uyarilar eklenebilir. ids işlem sonuçlarını, tmp geçici kimlik eşlemesini bildirir. Başarıyla dönen uyarı, kaydın reddedildiği anlamına gelmez.

Yan etkiyle değişen sürümleri tahmin etmeyin; yanıt verisini veya yeni bir okuma sonucunu kullanın. Genel nesne ve cihaz kuralları Nesne türleri sayfasındadır.