주문 생성 V3

TIP

• 이 API는 대여 기간이 5분으로 고정된 주문만 생성합니다. 에너지가 충분하면 주문이 성공합니다. 다른 조건으로 주문하려면 플랫폼의 자유 거래 시장을 이용하세요. 자유 거래 시장에서 API로 주문해야 한다면 문의해 주세요.
• 에너지가 충분하면 보통 3~6초 안에 수신 주소로 위임됩니다.
• V2 API는 더 다양한 대여 기간을 지원합니다.
• V3 API는 2024년 12월에 출시되었습니다. V2보다 저렴하지만 대여 기간은 5분으로 고정됩니다. 5분이면 충분하다면 V3 API를 권장합니다.

API 엔드포인트

POST /v3/order/create

요청 매개변수

이름	위치	유형	필수	설명
resource_type	body	integer	false	0은 대역폭, 1은 에너지
receive_address	body	string	true	자원 수신 주소
resource_value	body	integer	true	대여 자원량

매개변수 예시

{
    "resource_type": 1,
    "receive_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
    "resource_value": 32000
}

API 응답

이름	유형	필수	설명
code	integer	true
msg	string	true
request_id	string	true
data	BuyOrderDetail	false

응답 예시

{
    "code": 0,
    "msg": "成功",
    "request_id": "4fb9aac4-573f-4c3a-afc6-94d68270b12c",
    "data": {
        "order_no": "2409254945397237760100",
        "resource_type": 1,
        "receive_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
        "price_in_sun": 120,
        "freeze_time": 0,
        "create_time": 1727254190,
        "resource_value": 32000,
        "frozen_resource_value": 0,
        "rent_duration": 5,
        "rent_time_unit": "m",
        "rent_time_second": 300,
        "rent_expire_time": 0,
        "frozen_tx_id": "",
        "pay_time": 1727254190,
        "pay_amount": 4.4,
        "refund_amount": 0,
        "refund_time": 0,
        "is_split": 0,
        "is_lock": 1,
        "lock_period": 28800,
        "status": 4,
        "business_status": 1
    }
}

코드 예시

Shell

curl --location --request POST 'https://feee.io/open/v3/order/create' \
--header 'key: <key>' \
--header 'User-Agent: Feee.io Shell Client/1.0.0 (https://feee.io)' \
--header 'Content-Type: application/json' \
--data-raw '<body data here>'

Golang

package main

import (
   "fmt"
   "strings"
   "net/http"
   "io/ioutil"
)

func main() {

   url := "https://feee.io/open/v3/order/create"
   method := "POST"

   payload := strings.NewReader(`<body data here>`)

   client := &http.Client {
   }
   req, err := http.NewRequest(method, url, payload)

   if err != nil {
      fmt.Println(err)
      return
   }
   req.Header.Add("key", "<key>")
   req.Header.Add("User-Agent", "Feee.io Golang Client/1.0.0 (https://feee.io)")
   req.Header.Add("Content-Type", "application/json")

   res, err := client.Do(req)
   if err != nil {
      fmt.Println(err)
      return
   }
   defer res.Body.Close()

   body, err := ioutil.ReadAll(res.Body)
   if err != nil {
      fmt.Println(err)
      return
   }
   fmt.Println(string(body))
}

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
   CURLOPT_URL => 'https://feee.io/open/v3/order/create',
   CURLOPT_RETURNTRANSFER => true,
   CURLOPT_ENCODING => '',
   CURLOPT_MAXREDIRS => 10,
   CURLOPT_TIMEOUT => 0,
   CURLOPT_FOLLOWLOCATION => true,
   CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
   CURLOPT_CUSTOMREQUEST => 'POST',
   CURLOPT_POSTFIELDS =>'<body data here>',
   CURLOPT_HTTPHEADER => array(
      'key: <key>',
      'User-Agent: Feee.io PHP Client/1.0.0 (https://feee.io)',
      'Content-Type: application/json'
   ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Python

import http.client
import json

conn = http.client.HTTPSConnection("feee.io")
payload = "<body data here>"
headers = {
   'key': '<key>',
   'User-Agent': 'Feee.io Python Client/1.0.0 (https://feee.io)',
   'Content-Type': 'application/json'
}
conn.request("POST", "/open/v3/order/create", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

Java

OkHttpClient client = new OkHttpClient().newBuilder()
   .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "<body data here>");
Request request = new Request.Builder()
   .url("https://feee.io/open/v3/order/create")
   .method("POST", body)
   .addHeader("key", "<key>")
   .addHeader("User-Agent", "Feee.io Java Client/1.0.0 (https://feee.io)")
   .addHeader("Content-Type", "application/json")
   .build();
Response response = client.newCall(request).execute();