Hızlı başlangıç

Bu rehber, entegrasyondan ilk siparişe giden en kısa yoldur.

1. Kimlik bilgisi oluşturun

Panel → API bölümünü açın, API anahtarı oluştur seçeneğini kullanın ve iki değeri de saklayın:

• api_key — genel kimlik bilgisi tanımlayıcısı;
• api_secret — yalnızca bir kez gösterilen sır.

Sırrı örneğin RENTRON_API_SECRET içinde sunucunuzda tutun. Tarayıcıya, mobil uygulamaya, URL'ye veya kayda asla koymayın.

2. Sunucu saatini kontrol edin

curl https://api.rentron.xyz/v1/time

{"unix_time":1784376000}

İmzalı istekteki zaman damgası, sunucu saatinden en fazla beş dakika farklı olmalıdır.

3. Sipariş seçeneklerini okuyun

GET /v1/energy/options isteğini imzalayın. Birim büyüklüğünü, izin verilen süreleri ve sipariş kabulünün açık olup olmadığını döndürür.

{"energy_per_portion":65000,"max_energy":1300000,"duration_hours":[1],"intake_enabled":true}

4. Sipariş oluşturun

JSON'u bir kez seri hale getirin ve gönderdiğiniz baytların aynısını imzalayın.

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

POST /v1/energy/orders HTTP/1.1
Host: api.rentron.xyz
Content-Type: application/json
Authorization: HMAC-SHA256 {api_key}:{base64_signature}
X-Request-Timestamp: 1784376000

Yeni sipariş 201 Created, sipariş JSON'u ve Location: /v1/energy/orders/{id} döndürür. Aynı isteğin tekrarı mevcut siparişi 200 OK ile döndürür. Son teklifin tam total_trx değerini gönderin. energy_price_changed dönerse yeni teklif alın ve tekrar onaylayın; sipariş veya bloke oluşturulmamıştır.

5. Tamamlanmayı bekleyin

Location yolunu 1, 2 ve 5 saniye sonra, ardından her 10 saniyede bir sorgulayın. Yalnızca iki değer de true olduğunda durun:

{"lifecycle_final":true,"delivery_final":true}

Sonraki adım: siparişi sorgulama, sorgulama ve yeniden denemeler, API hataları.