Публичный API Jangrok

Простой REST API для работы со своими заказами, чатами и лотами — например, чтобы автоматически выдавать товар или синхронизировать цены из внешней системы. Примеры ниже — на cURL, JavaScript, Python, PHP и Go, переключаются вкладками.

Базовый URL

https://jangrok.site/api/v1

Авторизация

Каждый запрос — с заголовком Authorization: Bearer <ключ>. Создать ключ можно в разделе API-ключей профиля после входа.

Права доступа (scope)

У каждого ключа — свой набор прав, выбирается при создании. Ключ без нужного права получит 403 на соответствующем эндпоинте.

`read_orders`	Читать свои заказы
`write_orders`	Подтверждать получение заказа
`read_chat`	Читать сообщения своих чатов
`write_chat`	Отправлять сообщения в свои чаты
`edit_listings`	Редактировать свои лоты (цена, название, описание)

Ошибки и лимиты

Ошибка — всегда JSON с полем error и соответствующим HTTP-статусом:

{"error": "Invalid or revoked API key"}

`401`	Нет заголовка `Authorization`, ключ неверный или отозван
`403`	У ключа нет нужного права (scope)
`404`	Ресурс не найден или принадлежит не тебе
`400`	Некорректные данные в запросе
`409`	Заказ не в том статусе для этого действия
`429`	Превышен лимит запросов

Лимит — 60 запросов/мин на ключ по умолчанию, настраивается при создании ключа (до 300/мин).

GET /orders read_orders

Список твоих заказов — и как покупателя, и как продавца, последние 100, новые сначала.

Запрос

curl https://jangrok.site/api/v1/orders \
  -H "Authorization: Bearer pm_твой_ключ"

const res = await fetch("https://jangrok.site/api/v1/orders", {
  headers: { "Authorization": "Bearer pm_твой_ключ" }
});
const data = await res.json();
console.log(data.orders);

import requests

r = requests.get(
    "https://jangrok.site/api/v1/orders",
    headers={"Authorization": "Bearer pm_твой_ключ"},
)
print(r.json()["orders"])

<?php
$ch = curl_init("https://jangrok.site/api/v1/orders");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer pm_твой_ключ"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$data = json_decode(curl_exec($ch), true);
print_r($data["orders"]);

req, _ := http.NewRequest("GET", "https://jangrok.site/api/v1/orders", nil)
req.Header.Set("Authorization", "Bearer pm_твой_ключ")
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)

Ответ 200

{
  "orders": [
    {
      "id": 4821,
      "listing_title": "1000 робуксов",
      "quantity": 1,
      "price_paid_total": "899.00",
      "status": "in_progress",
      "role": "buyer",
      "created_at": "2026-09-15 12:03:44"
    }
  ]
}

GET /orders/{id} read_orders

Детали одного заказа — только если ты покупатель или продавец в нём, иначе 404.

Запрос

curl https://jangrok.site/api/v1/orders/4821 \
  -H "Authorization: Bearer pm_твой_ключ"

const res = await fetch("https://jangrok.site/api/v1/orders/4821", {
  headers: { "Authorization": "Bearer pm_твой_ключ" }
});
const order = await res.json();
console.log(order.status);

import requests

r = requests.get(
    "https://jangrok.site/api/v1/orders/4821",
    headers={"Authorization": "Bearer pm_твой_ключ"},
)
print(r.json()["status"])

<?php
$ch = curl_init("https://jangrok.site/api/v1/orders/4821");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer pm_твой_ключ"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$order = json_decode(curl_exec($ch), true);
echo $order["status"];

req, _ := http.NewRequest("GET", "https://jangrok.site/api/v1/orders/4821", nil)
req.Header.Set("Authorization", "Bearer pm_твой_ключ")
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
var order map[string]interface{}
json.NewDecoder(resp.Body).Decode(&order)

Ответ 200

{
  "id": 4821,
  "listing_title": "1000 робуксов",
  "quantity": 1,
  "price_paid_total": "899.00",
  "status": "confirmed_frozen",
  "role": "buyer",
  "created_at": "2026-09-15 12:03:44",
  "confirmed_at": "2026-09-15 12:10:02"
}

POST /orders/{id}/confirm write_orders

Подтвердить получение — только для покупателя, и только пока заказ в статусе in_progress (иначе 409). Деньги продавца переходят в заморозку до автоматической разморозки.

Запрос

curl -X POST https://jangrok.site/api/v1/orders/4821/confirm \
  -H "Authorization: Bearer pm_твой_ключ"

const res = await fetch("https://jangrok.site/api/v1/orders/4821/confirm", {
  method: "POST",
  headers: { "Authorization": "Bearer pm_твой_ключ" }
});
const data = await res.json();
console.log(data.frozen_until);

import requests

r = requests.post(
    "https://jangrok.site/api/v1/orders/4821/confirm",
    headers={"Authorization": "Bearer pm_твой_ключ"},
)
print(r.json()["frozen_until"])

<?php
$ch = curl_init("https://jangrok.site/api/v1/orders/4821/confirm");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer pm_твой_ключ"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$data = json_decode(curl_exec($ch), true);
echo $data["frozen_until"];

req, _ := http.NewRequest("POST", "https://jangrok.site/api/v1/orders/4821/confirm", nil)
req.Header.Set("Authorization", "Bearer pm_твой_ключ")
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()

Ответ 200

{
  "status": "confirmed_frozen",
  "frozen_until": "2026-09-17 12:10:02"
}

GET /chats/{id}/messages read_chat

Сообщения чата, в котором ты участник. Параметр ?after=ID — только сообщения новее указанного id, удобно для опроса (polling) без повторной загрузки истории целиком.

Запрос

curl "https://jangrok.site/api/v1/chats/51/messages?after=1200" \
  -H "Authorization: Bearer pm_твой_ключ"

const res = await fetch("https://jangrok.site/api/v1/chats/51/messages?after=1200", {
  headers: { "Authorization": "Bearer pm_твой_ключ" }
});
const data = await res.json();
console.log(data.messages);

import requests

r = requests.get(
    "https://jangrok.site/api/v1/chats/51/messages",
    params={"after": 1200},
    headers={"Authorization": "Bearer pm_твой_ключ"},
)
print(r.json()["messages"])

<?php
$ch = curl_init("https://jangrok.site/api/v1/chats/51/messages?after=1200");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer pm_твой_ключ"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$data = json_decode(curl_exec($ch), true);
print_r($data["messages"]);

req, _ := http.NewRequest("GET", "https://jangrok.site/api/v1/chats/51/messages?after=1200", nil)
req.Header.Set("Authorization", "Bearer pm_твой_ключ")
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()

Ответ 200

{
  "messages": [
    {
      "id": 1201,
      "sender_id": 7,
      "content": "Данные отправлены, проверьте почту",
      "created_at": "2026-09-15 12:11:30"
    }
  ]
}

POST /chats/{id}/messages write_chat

Отправить сообщение в чат, в котором ты участник. Текст — до 2000 символов, пустое сообщение не примется.

Запрос

curl -X POST https://jangrok.site/api/v1/chats/51/messages \
  -H "Authorization: Bearer pm_твой_ключ" \
  -H "Content-Type: application/json" \
  -d '{"message": "Данные отправлены, проверьте почту"}'

const res = await fetch("https://jangrok.site/api/v1/chats/51/messages", {
  method: "POST",
  headers: {
    "Authorization": "Bearer pm_твой_ключ",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({ message: "Данные отправлены, проверьте почту" })
});
const data = await res.json();

import requests

r = requests.post(
    "https://jangrok.site/api/v1/chats/51/messages",
    headers={"Authorization": "Bearer pm_твой_ключ"},
    json={"message": "Данные отправлены, проверьте почту"},
)
print(r.json())

<?php
$ch = curl_init("https://jangrok.site/api/v1/chats/51/messages");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer pm_твой_ключ",
    "Content-Type: application/json",
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
    "message" => "Данные отправлены, проверьте почту",
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$data = json_decode(curl_exec($ch), true);

body := strings.NewReader(`{"message": "Данные отправлены, проверьте почту"}`)
req, _ := http.NewRequest("POST", "https://jangrok.site/api/v1/chats/51/messages", body)
req.Header.Set("Authorization", "Bearer pm_твой_ключ")
req.Header.Set("Content-Type", "application/json")
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()

Ответ 200

{
  "id": 1201,
  "sender_id": 7,
  "content": "Данные отправлены, проверьте почту"
}

PATCH /listings/{id} edit_listings

Изменить свой лот — передавай только те поля, которые хочешь обновить, остальные останутся как были. Хотя бы одно поле обязательно.

Запрос

curl -X PATCH https://jangrok.site/api/v1/listings/930 \
  -H "Authorization: Bearer pm_твой_ключ" \
  -H "Content-Type: application/json" \
  -d '{"price": "849.00"}'

const res = await fetch("https://jangrok.site/api/v1/listings/930", {
  method: "PATCH",
  headers: {
    "Authorization": "Bearer pm_твой_ключ",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({ price: "849.00" })
});
const data = await res.json();

import requests

r = requests.patch(
    "https://jangrok.site/api/v1/listings/930",
    headers={"Authorization": "Bearer pm_твой_ключ"},
    json={"price": "849.00"},
)
print(r.json())

<?php
$ch = curl_init("https://jangrok.site/api/v1/listings/930");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "PATCH");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer pm_твой_ключ",
    "Content-Type: application/json",
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode(["price" => "849.00"]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$data = json_decode(curl_exec($ch), true);

body := strings.NewReader(`{"price": "849.00"}`)
req, _ := http.NewRequest("PATCH", "https://jangrok.site/api/v1/listings/930", body)
req.Header.Set("Authorization", "Bearer pm_твой_ключ")
req.Header.Set("Content-Type", "application/json")
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()

Ответ 200

{
  "status": "updated",
  "listing_id": 930
}