Order port

POST

/ports/order

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "POST");
curl_easy_setopt(hnd, CURLOPT_URL, "https://api.ltesocks.io/v2/ports/order");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer <token>");
headers = curl_slist_append(headers, "Content-Type: application/json");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

curl_easy_setopt(hnd, CURLOPT_POSTFIELDS, "{ \"plan\": \"5349b4ddd2781d08c09890f3\", \"tarification\": { \"time\": 2592000, \"traffic\": 51200, \"price\": 14500 } }");

CURLcode ret = curl_easy_perform(hnd);

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
    Method = HttpMethod.Post,
    RequestUri = new Uri("https://api.ltesocks.io/v2/ports/order"),
    Headers =
    {
        { "Authorization", "Bearer <token>" },
    },
    Content = new StringContent("{ \"plan\": \"5349b4ddd2781d08c09890f3\", \"tarification\": { \"time\": 2592000, \"traffic\": 51200, \"price\": 14500 } }")
    {
        Headers =
        {
            ContentType = new MediaTypeHeaderValue("application/json")
        }
    }
};
using (var response = await client.SendAsync(request))
{
    response.EnsureSuccessStatusCode();
    var body = await response.Content.ReadAsStringAsync();
    Console.WriteLine(body);
}

package main

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

func main() {

  url := "https://api.ltesocks.io/v2/ports/order"

  payload := strings.NewReader("{ \"plan\": \"5349b4ddd2781d08c09890f3\", \"tarification\": { \"time\": 2592000, \"traffic\": 51200, \"price\": 14500 } }")

  req, _ := http.NewRequest("POST", url, payload)

  req.Header.Add("Authorization", "Bearer <token>")
  req.Header.Add("Content-Type", "application/json")

  res, _ := http.DefaultClient.Do(req)

  defer res.Body.Close()
  body, _ := io.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))

}

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.ltesocks.io/v2/ports/order"))
    .header("Authorization", "Bearer <token>")
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString("{ \"plan\": \"5349b4ddd2781d08c09890f3\", \"tarification\": { \"time\": 2592000, \"traffic\": 51200, \"price\": 14500 } }"))
    .build();
HttpResponse<String> response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{ \"plan\": \"5349b4ddd2781d08c09890f3\", \"tarification\": { \"time\": 2592000, \"traffic\": 51200, \"price\": 14500 } }");
Request request = new Request.Builder()
  .url("https://api.ltesocks.io/v2/ports/order")
  .post(body)
  .addHeader("Authorization", "Bearer <token>")
  .addHeader("Content-Type", "application/json")
  .build();

Response response = client.newCall(request).execute();

import axios from 'axios';

const options = {
  method: 'POST',
  url: 'https://api.ltesocks.io/v2/ports/order',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  data: {
    plan: '5349b4ddd2781d08c09890f3',
    tarification: {time: 2592000, traffic: 51200, price: 14500}
  }
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

const url = 'https://api.ltesocks.io/v2/ports/order';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"plan":"5349b4ddd2781d08c09890f3","tarification":{"time":2592000,"traffic":51200,"price":14500}}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

val client = OkHttpClient()

val mediaType = MediaType.parse("application/json")
val body = RequestBody.create(mediaType, "{ \"plan\": \"5349b4ddd2781d08c09890f3\", \"tarification\": { \"time\": 2592000, \"traffic\": 51200, \"price\": 14500 } }")
val request = Request.Builder()
  .url("https://api.ltesocks.io/v2/ports/order")
  .post(body)
  .addHeader("Authorization", "Bearer <token>")
  .addHeader("Content-Type", "application/json")
  .build()

val response = client.newCall(request).execute()

use serde_json::json;
use reqwest;

#[tokio::main]
pub async fn main() {
    let url = "https://api.ltesocks.io/v2/ports/order";

    let payload = json!({
        "plan": "5349b4ddd2781d08c09890f3",
        "tarification": json!({
            "time": 2592000,
            "traffic": 51200,
            "price": 14500
        })
    });

    let mut headers = reqwest::header::HeaderMap::new();
    headers.insert("Authorization", "Bearer <token>".parse().unwrap());
    headers.insert("Content-Type", "application/json".parse().unwrap());

    let client = reqwest::Client::new();
    let response = client.post(url)
        .headers(headers)
        .json(&payload)
        .send()
        .await;

    let results = response.unwrap()
        .json::<serde_json::Value>()
        .await
        .unwrap();

    dbg!(results);
}

curl --request POST \
  --url https://api.ltesocks.io/v2/ports/order \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "plan": "5349b4ddd2781d08c09890f3", "tarification": { "time": 2592000, "traffic": 51200, "price": 14500 } }'

wget --quiet \
  --method POST \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --body-data '{ "plan": "5349b4ddd2781d08c09890f3", "tarification": { "time": 2592000, "traffic": 51200, "price": 14500 } }' \
  --output-document \
  - https://api.ltesocks.io/v2/ports/order

Legacy JSON and HTTP statuses are preserved, including error objects and HTTP 500 for insufficient balance and validation failures. Idempotency uses the configured TTL and lock timeout; server errors are not cached by default. Optional X-LTESocks-Order-State is not-created, created, or unknown. Only not-created proves that this attempt did not create an order. A missing response or unknown state must not be treated as a safe retry. X-LTESocks-Error-Code can be priceChanged, insufficientBalance, validationFailed, unauthorized, forbidden, portDetailsUnavailable, upstreamError, or idempotencyConflict. These headers are additive and do not change the handling of another POST.

Authorizations

bearerAuth

Parameters

Header Parameters

Idempotency-Key

string format: uuid

Optional UUID that identifies one mutation request. Reuse it only when retrying the same request.

Request Body^required

Plan parameters

application/json

object

plan

Plan ID

string

Example

5349b4ddd2781d08c09890f3

tarification

object

time

Plan duration time in seconds

integer

Example

traffic

Plan traffic amount in megabytes

integer

Example

price

Plan price in cents

integer

Example

Responses

200

Successful operation

application/json

object

port

Port number

string

Port current IP address (0.0.0.0 if not available)

string

geoip

object

continentCode

string

continentName

string

countryCode2

string

countryCode3

string

stateProv

string

district

string

city

string

zipcode

string

latitude

string

longitude

string

isp

string

status

Port status

string

Allowed values: active reset suspended disconnected outoftraffic

currentStatus

Current status

string

Allowed values: active declined

resetToken

Port reset token

string

signature

Port signature

string

vpnAccess

Indicates whether port has access to the VPN server

boolean

autoResetInterval

Port auto reset interval in seconds, 0 means disabled

integer

tags

Port tags

Array<string>

<= 30 characters

plan

object

Plan ID

string

name

Plan title

string

countryCode

Plan country code

string

enabled

Indicates whether plan is active

boolean

autoRenew

Indicates whether plan auto renewal is active

boolean

activatedAt

Plan activation time

string format: date-time

expiresAt

Plan expiration time

string format: date-time

trafficRemains

Remaining traffic amount in megabytes

integer

tarification

object

time

Plan duration time in seconds

integer

traffic

Plan traffic amount in megabytes

integer

price

Plan price in cents

integer

credentials

object

Array<string>

<= 20 characters

password

Array<object>

<= 20 characters

object

login

string

password

string

Example

{
  "port": 10000,
  "ip": "1.1.1.1",
  "geoip": {
    "continentCode": "NA",
    "continentName": "North America",
    "countryCode2": "US",
    "countryCode3": "United States",
    "latitude": "38.89037",
    "longitude": "-77.03196",
    "isp": "T-Mobile USA, Inc."
  },
  "status": "active",
  "currentStatus": "active",
  "resetToken": "6015510d206e4d7b023e5f978a56e3cf49d7e79bc26cf28c69b75314e098a61b",
  "signature": "Windows",
  "vpnAccess": true,
  "plan": {
    "id": "5349b4ddd2781d08c09890f3",
    "name": "UK Three",
    "countryCode": "UK",
    "enabled": true,
    "autoRenew": true,
    "activatedAt": "2022-04-02T05:57:29.054Z",
    "expiresAt": "2022-05-02T05:57:29.054Z",
    "trafficRemains": 51200,
    "tarification": {
      "time": 2592000,
      "traffic": 51200,
      "price": 14500
    }
  },
  "credentials": {
    "ip": [
      "2.2.2.2"
    ],
    "password": [
      {
        "login": "login",
        "password": "password"
      }
    ]
  }
}

Headers

X-LTESocks-Order-State

string

Allowed values: created

401

Unauthenticated (legacy error object).

application/json

object

error

required

Error text representation

string

code

required

Error code representation

integer

Example

{
  "error": "example error",
  "code": 400
}

409

Price changed; legacy error object without quote data. Reload plans before confirming again.

application/json

object

error

required

Error text representation

string

code

required

Error code representation

integer

Example

{
  "error": "example error",
  "code": 400
}

Headers

X-LTESocks-Error-Code

string

Allowed values: priceChanged

X-LTESocks-Order-State

string

Allowed values: not-created

500

Legacy error. Optional retry headers are preserved.

application/json

object

error

required

Error text representation

string

code

required

Error code representation

integer

Example

{
  "error": "example error",
  "code": 400
}

Headers

X-LTESocks-Order-State

string

Allowed values: not-created created unknown

X-LTESocks-Error-Code

string

Retry-After

string

Retry-At

string

Order port

Authorizations

Parameters

Header Parameters

Request Bodyrequired

Example

Example

Example

Example

Responses

200

Example

Headers

401

Example

409

Example

Headers

500

Example

Headers

Request Body^required