Ana içeriğe geç

Ticaret Oluştur

Sistemde yeni bir ticaret oluşturur.

İstek

POST /api/v1/trades

Parametreler

İsimTipYerAçıklama
namestringbodyGerekli. Ticaretin adı
node_idstringbodyGerekli. Ticaretin oluşturulacağı düğümün ID'si
typenumberbodyGerekli. Ticaretin türü (1: İthalat, 2: İhracat)

Ticaret Türleri

DeğerAçıklama
1İthalat
2İhracat

Ticaret Durumları

DeğerAçıklama
1Beklemede
2Tamamlandı
3Başarısız
4Reddedildi

Başlıklar

İsimAçıklama
AuthorizationGerekli. Kimlik doğrulama için Bearer token
Content-TypeGerekli. application/json olmalıdır
X-Target-ServerGerekli. 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 KoduAçıklama
200Başarılı
400Hatalı İstek - Geçersiz parametreler
401Yetkisiz - Geçersiz veya eksik kimlik doğrulama tokeni
404Bulunamadı - Düğüm ID'si mevcut değil
500Sunucu Hatası