Optik ölçümler referansı

Optik ölçümler uçlarının kimlik, parametre, istek ve yanıt sözleşmeleri.

Son güncelleme: 2026-11-10

Bu sayfada

GET /api/p/{pid}/optik POST /api/p/{pid}/optik/{oid}/dosya GET /api/p/{pid}/optik/{oid}/dosya POST /api/p/{pid}/optik/{oid}/sor-uygula GET /api/p/{pid}/optik/rapor

Yol, yöntem, parametre ve mevcut şemalar depodaki OpenAPI çıktısından üretilir.

Dikkat: Bu uçlar tarayıcı uygulamasının sözleşmesidir; sürüm güvencesi v1 kadar değildir. Dış entegrasyonlarda sürümlü API tercih edilmelidir.

GET `/api/p/{pid}/optik`

Get Optik

Kütüphane (ürün), proje profilleri (başvuru özetiyle) ve seçim. Görüntüleyici okur; fiber kapalıysa 403.

Kimlik: Kullanıcı oturumu (çerez). Kapsam: İlgili kurum/proje üyeliği ve işlem yetkisi; yazma işlemlerinde güncel rol, modül ve lisans izinleri ayrıca denetlenir.

Parametreler

Ad	Yer	Tür	Zorunlu
`pid`	yol	integer	Evet
`kapali`	sorgu	integer	Hayır

Yanıtlar

HTTP 200

application/json

Bu OpenAPI çıktısında gövde şeması tanımlanmamıştır. Ayrıntı için ilgili geliştirici belgesini kullanın.

HTTP 422

application/json

Alan	Tür	Zorunlu	Açıklama
`detail`	ValidationError[]	Hayır

Hata yanıtlarının anlamı ve istemci davranışları için hata kodları sözlüğünü inceleyin.

POST `/api/p/{pid}/optik/{oid}/dosya`

Optik Dosya Yukle

Kimlik: Kullanıcı oturumu (çerez). Kapsam: İlgili kurum/proje üyeliği ve işlem yetkisi; yazma işlemlerinde güncel rol, modül ve lisans izinleri ayrıca denetlenir.

Parametreler

Ad	Yer	Tür	Zorunlu
`pid`	yol	integer	Evet
`oid`	yol	string	Evet
`version`	sorgu	integer \| null	Hayır

İstek gövdesi

multipart/form-data

Alan	Tür	Zorunlu	Açıklama
`file`	string	Evet

Yanıtlar

HTTP 200

application/json

Bu OpenAPI çıktısında gövde şeması tanımlanmamıştır. Ayrıntı için ilgili geliştirici belgesini kullanın.

HTTP 422

application/json

Alan	Tür	Zorunlu	Açıklama
`detail`	ValidationError[]	Hayır

Hata yanıtlarının anlamı ve istemci davranışları için hata kodları sözlüğünü inceleyin.

GET `/api/p/{pid}/optik/{oid}/dosya`

Optik Dosya Indir

Ölçüm dosyası indirme (okuma yetkisi; fiber kapalıysa 403). Bayt özeti saklanan sha256 ile denetlenir; paketle taşınmamış dosya `dosya_yok`.

Kimlik: Kullanıcı oturumu (çerez). Kapsam: İlgili kurum/proje üyeliği ve işlem yetkisi; yazma işlemlerinde güncel rol, modül ve lisans izinleri ayrıca denetlenir.

Parametreler

Ad	Yer	Tür	Zorunlu
`pid`	yol	integer	Evet
`oid`	yol	string	Evet
`kapali`	sorgu	integer	Hayır

Yanıtlar

HTTP 200

application/json

Bu OpenAPI çıktısında gövde şeması tanımlanmamıştır. Ayrıntı için ilgili geliştirici belgesini kullanın.

HTTP 422

application/json

Alan	Tür	Zorunlu	Açıklama
`detail`	ValidationError[]	Hayır

Hata yanıtlarının anlamı ve istemci davranışları için hata kodları sözlüğünü inceleyin.

POST `/api/p/{pid}/optik/{oid}/sor-uygula`

Optik Sor Uygula

SOR önerilerini açık alan seçimiyle, ölçümün mevcut CAS yazma yoluna uygular.

Kimlik: Kullanıcı oturumu (çerez). Kapsam: İlgili kurum/proje üyeliği ve işlem yetkisi; yazma işlemlerinde güncel rol, modül ve lisans izinleri ayrıca denetlenir.

Parametreler

Ad	Yer	Tür	Zorunlu
`pid`	yol	integer	Evet
`oid`	yol	string	Evet

İstek gövdesi

application/json

Tür: object.

{
  "type": "object",
  "additionalProperties": true,
  "title": "Body"
}

Yanıtlar

HTTP 200

application/json

Bu OpenAPI çıktısında gövde şeması tanımlanmamıştır. Ayrıntı için ilgili geliştirici belgesini kullanın.

HTTP 422

application/json

Alan	Tür	Zorunlu	Açıklama
`detail`	ValidationError[]	Hayır

Hata yanıtlarının anlamı ve istemci davranışları için hata kodları sözlüğünü inceleyin.

GET `/api/p/{pid}/optik/rapor`

Optik Rapor

F7-2 ölçüm raporu (K14, §7/10; F8 girdisi): her ölçüm kendi hesap bağıyla karşılaştırılır (S6), bağlı hesabın bugünkü eskiliği; tek tutarlı veri anı (`generated_at` + son changes.id). format=csv: ';' ayraç, UTF-8 BOM, ondalık virgül, formül enjeksiyonu korumalı.

Kimlik: Kullanıcı oturumu (çerez). Kapsam: İlgili kurum/proje üyeliği ve işlem yetkisi; yazma işlemlerinde güncel rol, modül ve lisans izinleri ayrıca denetlenir.

Parametreler

Ad	Yer	Tür	Zorunlu
`pid`	yol	integer	Evet
`format`	sorgu	string	Hayır
`devre`	sorgu	string \| null	Hayır
`tur`	sorgu	string \| null	Hayır
`durum`	sorgu	string \| null	Hayır
`limit`	sorgu	integer	Hayır
`offset`	sorgu	integer	Hayır
`kapali`	sorgu	integer	Hayır

Yanıtlar

HTTP 200

application/json

Bu OpenAPI çıktısında gövde şeması tanımlanmamıştır. Ayrıntı için ilgili geliştirici belgesini kullanın.

HTTP 422

application/json

Alan	Tür	Zorunlu	Açıklama
`detail`	ValidationError[]	Hayır

Hata yanıtlarının anlamı ve istemci davranışları için hata kodları sözlüğünü inceleyin.