Ticaret Oluştur
Sistemde yeni bir ticaret oluşturur.
İstek
POST /api/v1/trades
Parametreler
| İsim | Tip | Yer | Açıklama |
|---|---|---|---|
name | string | body | Gerekli. Ticaretin adı |
node_id | string | body | Gerekli. Ticaretin oluşturulacağı düğümün ID'si |
type | number | body | Gerekli. Ticaretin türü (1: İthalat, 2: İhracat) |
Ticaret Türleri
| Değer | Açıklama |
|---|---|
| 1 | İthalat |
| 2 | İhracat |
Ticaret Durumları
| Değer | Açıklama |
|---|---|
| 1 | Beklemede |
| 2 | Tamamlandı |
| 3 | Başarısız |
| 4 | Reddedildi |
Başlıklar
| İsim | Açıklama |
|---|---|
Authorization | Gerekli. Kimlik doğrulama için Bearer token |
Content-Type | Gerekli. application/json olmalıdır |
X-Target-Server | Gerekli. Hedef sunucu tanımlayıcısı |
Örnek
curl --request POST \
--url '{{HOST}}/api/v1/trades?page=1&per_page=10' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...' \
--header 'Content-Type: application/json' \
--header 'X-Target-Server: declaration' \
--data '{
"name": "API Trade",
"node_id": "6784fea5481a2963fcb2d74c",
"type": 1
}'
Yanıt
Başarılı bir istek, oluşturulan ticaret bilgileriyle birlikte HTTP 200 durum kodu döndürür.
{
"id": "68247532b5e19b4fafa3f894",
"declaration_id": "7428912381230128310238",
"name": "API Trade",
"node_name": "Interzoon A.S",
"node_id": "6784fea5481a2963fcb2d74c",
"status": 1,
"type": 1,
"permissions": [],
"created_by": "6784fea5481a2963fcb2d74d",
"created_at": "2025-05-14T13:49:22.835726+03:00",
"updated_at": "2025-05-14T13:49:22.835726+03:00"
}
Durum Kodları
| Durum Kodu | Açıklama |
|---|---|
| 200 | Başarılı |
| 400 | Hatalı İstek - Geçersiz parametreler |
| 401 | Yetkisiz - Geçersiz veya eksik kimlik doğrulama tokeni |
| 404 | Bulunamadı - Düğüm ID'si mevcut değil |
| 500 | Sunucu Hatası |