Procurement API: Kritik malzemeler uç noktaları (critical_materials)

Bu sayfa procurement modülünün critical_materials alt modülündeki 6 uç noktayı /api/v1/procurement altında listeler. Kapsam: Kritik malzeme kayıtları. Modül giriş sayfası Procurement API sayfasıdır.

Grup olguları¶

Öğe	Değer	Kaynak
Temel yol	`/api/v1/procurement`	`src/cluster_erp/core/module_base.py:37-38`, `src/cluster_erp/modules/procurement/module.py:70`
Yönlendiriciler	1 dosyada 1 yönlendirici nesnesi; Uç noktalar bölümünde listelenir	`src/cluster_erp/modules/procurement/module.py:35`
Uç noktalar	6; `register_routes` ile bağlanan yönlendiricilerin yol dekoratörleri ve `add_api_route` çağrılarından sayıldı	`src/cluster_erp/modules/procurement/critical_materials/routes.py`
Kimlik doğrulama	Bearer başlığı veya oturum çerezi, `get_current_user` ile çözülür; bkz. Kimlik doğrulama ve başlıklar	`src/cluster_erp/modules/auth/guards.py:85-167`
Yetki koruması	6 yolun 6 tanesi `require_permission` bildirir	`src/cluster_erp/modules/auth/guards.py:205-240`
Uygulama yetkilendirme kapısı	bağlanan her yönlendiricide `require_app("procurement")`	`src/cluster_erp/modules/procurement/module.py:82`
Hata biçimi	JSON gövdesi `{"error": {...}}`; bkz. Hatalar	`src/cluster_erp/server/error_handler.py:33-46`

Uç noktalar¶

Yöntem	Yol	İşleyici	Yetki	İstek	Sorgu	Yanıt	Durum	Kaynak
`GET`	`/api/v1/procurement/critical-materials/`	`list_critical_materials`	`critical_material.read`	yok	`is_active`, `search`, `limit`, `offset`	`dict`	200 (varsayılan)	`src/cluster_erp/modules/procurement/critical_materials/routes.py:27`
`POST`	`/api/v1/procurement/critical-materials/`	`create_critical_material`	`critical_material.create`	`CriticalMaterialCreate`	yok	`CriticalMaterialRead`	`201`	`src/cluster_erp/modules/procurement/critical_materials/routes.py:53`
`GET`	`/api/v1/procurement/critical-materials/{cm_id}`	`get_critical_material`	`critical_material.read`	yok	yok	`CriticalMaterialRead`	200 (varsayılan)	`src/cluster_erp/modules/procurement/critical_materials/routes.py:65`
`PUT`	`/api/v1/procurement/critical-materials/{cm_id}`	`update_critical_material`	`critical_material.update`	`CriticalMaterialUpdate`	yok	`CriticalMaterialRead`	200 (varsayılan)	`src/cluster_erp/modules/procurement/critical_materials/routes.py:79`
`DELETE`	`/api/v1/procurement/critical-materials/{cm_id}`	`delete_critical_material`	`critical_material.delete`	yok	yok	yok	`204`	`src/cluster_erp/modules/procurement/critical_materials/routes.py:94`
`POST`	`/api/v1/procurement/critical-materials/bulk-delete`	`bulk_delete_critical_materials`	`critical_material.bulk_delete`	`BulkDeleteRequest`	yok	`BulkDeleteResponse`	200 (varsayılan)	`src/cluster_erp/modules/procurement/critical_materials/routes.py:106`

Hata kodları¶

Tablo, src/cluster_erp/modules/procurement/critical_materials/ altındaki kodun attığı hata kodlarını listeler. Kodlar, AppError(...) çağrıları, src/cluster_erp/core/errors.py içindeki fabrikalar (not_found, conflict, protected, permission_denied, privilege_escalation, check_version) ve HTTPException(...) için yapılan bir sözdizimi ağacı taramasıyla bulundu. 400 durumu AppError varsayılanıdır (src/cluster_erp/core/errors.py:23). Koruma hataları (401, 403), yetkilendirme kodları ve doğrulama hataları (422) her yol için geçerlidir ve Hatalar sayfasında listelenir.

Kod	HTTP durumu	Atıldığı yer	İlk konum
`CONCURRENCY_VERSION_CONFLICT`	`409`	`services`	`src/cluster_erp/modules/procurement/critical_materials/services.py:127`
`CRITICAL_MATERIAL_ALREADY_EXISTS`	`409`	`services`	`src/cluster_erp/modules/procurement/critical_materials/services.py:86`
`RESOURCE_NOT_FOUND`	`404`	`routes`	`src/cluster_erp/modules/procurement/critical_materials/routes.py:75`

İlgili sayfalar¶

92f8051 numaralı commit ile 2026-11-13 tarihinde doğrulandı.