Sipariş oluşturun

Her iş olayı için kararlı ve benzersiz bir client_request_id gerekir. Ağ yeniden denemelerinde gereken tekrar koruması budur.

İstek gövdesi

{"client_request_id":"order-1042","address":"TXYZ","energy":65000,"duration_hours":1,"expected_total_trx":"3.200000"}

Alan	Tür	Zorunlu	Açıklama
client_request_id	string	evet	Benzersiz işlem kimliğiniz. Yalnızca bu sipariş için yeniden kullanın.
address	string	evet	USDT işlemini gönderecek ve Energy tahsisini alacak geçerli TRON adresi.
energy	integer	evet	Pozitif ve birim büyüklüğüne kalansız bölünen miktar.
duration_hours	integer	evet	Seçeneklerden izin verilen süre.
expected_total_trx	string	evet	Son teklifin tam, altı ondalıklı total_trx değeri.

Bilinmeyen JSON alanları reddedilir. Content-Type: application/json gönderin.

Yanıt 201 veya 200

{"id":"7c0c9a54-517c-4bbb-a946-bf14bf86c113","client_request_id":"order-1042","address":"TXYZ","energy":65000,"duration_hours":1,"total_trx":"3.200000","status":"created","lifecycle_final":false,"delivery_final":false,"created_at":1784376000,"updated_at":1784376000,"failure":null}

• 201 Created — yeni sipariş; Location, /v1/energy/orders/{id} yolunu içerir.
• 200 OK — tam aynı tekrar isteğinde mevcut sipariş döner.
• code: energy_order_idempotency_conflict olan 409 Conflict — aynı client_request_id, başka adres, miktar veya süreyle kullanılmıştır.
• code: energy_price_changed olan 409 Conflict — yeni teklif alın ve tekrar onaylayın. Sipariş veya TRX blokesi oluşturulmamıştır.

Tekrarlanabilirlik

Zaman aşımından sonra yeni kimlik üretmeyin. Aynı gövdeyi ve client_request_id değerini tekrar gönderin. Yeni kimlik yalnızca yeni iş olayı içindir.

Durum alanları

status güncel aşamayı belirtir. Otomasyon sabit bir durum listesi yerine lifecycle_final ve delivery_final alanlarını kullanmalıdır. Sipariş sorgulama sayfasına bakın.

Hatalar

Olası durumlar 400, 401, 409, 413, 415, 429 ve 503 değerleridir. Nedeni düzeltmeden 400, 401, 409, 413 veya 415 için otomatik yeniden deneme yapmayın.