Para Birimi Oluştur

Yeni para birimi oluşturur (Admin).

Endpoint

POST /api/v1/currencies

Authentication

Bu endpoint authentication gerektirir.

Header: Authorization: Bearer \{token\}

Permission

• currencies.create - Para birimi oluşturma

Request

Headers

Header	Değer	Zorunlu
Authorization	Bearer \{token\}	Evet
Content-Type	application/json	Evet

Request Body

Parametre	Tip	Zorunlu	Açıklama
code	string	Evet	Para birimi kodu (3 karakter, unique, uppercase, ISO 4217)
name	string	Evet	Para birimi adı (Türkçe)
symbol	string	Hayır	Para birimi sembolü (max: 10 karakter)
name_en	string	Hayır	Para birimi adı (İngilizce)
decimal_places	integer	Hayır	Ondalık basamak sayısı (min: 0, max: 8, varsayılan: 2)
sort_order	integer	Hayır	Sıralama sırası (min: 0, varsayılan: 0)
is_active	boolean	Hayır	Aktif durumu (varsayılan: true)
description	string	Hayır	Açıklama

Example Request

{
  "code": "TRY",
  "name": "Türk Lirası",
  "symbol": "₺",
  "name_en": "Turkish Lira",
  "decimal_places": 2,
  "sort_order": 1,
  "is_active": true,
  "description": "Türkiye Cumhuriyeti resmi para birimi"
}

Response

Success Response (201 Created)

{
  "id": 1,
  "code": "TRY",
  "name": "Türk Lirası",
  "symbol": "₺",
  "name_en": "Turkish Lira",
  "decimal_places": 2,
  "sort_order": 1,
  "is_active": true,
  "description": "Türkiye Cumhuriyeti resmi para birimi",
  "created_at": "2025-11-20T12:00:00.000000Z",
  "updated_at": "2025-11-20T12:00:00.000000Z"
}

Error Responses

403 Forbidden

{
  "message": "Forbidden"
}

422 Unprocessable Entity

{
  "message": "Validation failed",
  "errors": {
    "code": ["The code field is required.", "The code has already been taken."],
    "name": ["The name field is required."]
  }
}

Code Examples

cURL

curl -X POST https://api.example.com/api/v1/currencies \
  -H "Authorization: Bearer \{token\}" \
  -H "Content-Type: application/json" \
  -d '{
    "code": "TRY",
    "name": "Türk Lirası",
    "symbol": "₺",
    "name_en": "Turkish Lira",
    "decimal_places": 2
  }'

Notes

• code alanı unique olmalıdır ve ISO 4217 standardına uygun olmalıdır
• code otomatik olarak uppercase'e dönüştürülür
• is_active değeri belirtilmemişse varsayılan olarak true kullanılır
• decimal_places değeri belirtilmemişse varsayılan olarak 2 kullanılır
• sort_order değeri belirtilmemişse varsayılan olarak 0 kullanılır

Related Endpoints

• Para Birimi Listesi - Tüm para birimlerini listele
• Para Birimi Güncelle - Para birimi bilgilerini güncelle