Пагінація та ліміти запитів

Фільтровані запити портів, журналів портів і платежів приймають page та pageSize у JSON-тілі. Контракт обмежує pageSize значенням 100.

{
  "page": 1,
  "pageSize": 100
}

Відповіді містять data, page, pageSize і total. Продовжуйте, доки кількість зібраних елементів не досягне total або сторінка не поверне даних. Вміст колекції може змінюватися під час пагінації, тому не вважайте його знімком стану, якщо ваш сценарій не контролює записи.

Пагінатори офіційних SDK запитують наступні сторінки й повертають окремі елементи:

for await (const port of client.paginate(
  ({ page, pageSize }) =>
    client.ports.filter({ body: { page, pageSize, tags: ['Production1'] } }),
  { pageSize: 100 },
)) {
  console.log(port.port);
}

from ltesocks_sdk.models import FilterPortsBody

def fetch_page(*, page: int, page_size: int):
    return client.ports.filter(
        body=FilterPortsBody(
            page=page,
            page_size=page_size,
            tags=["Production1"],
        )
    )

for port in client.paginate(fetch_page, page_size=100):
    print(port.port)

<?php

use LTESocks\Dto\FilterPortsRequest;

$ports = $client->paginate(
    fn (int $page, int $pageSize) => $client->ports()->filter(
        new FilterPortsRequest([
            'page' => $page,
            'pageSize' => $pageSize,
            'tags' => ['Production1'],
        ]),
    ),
);

foreach ($ports as $port) {
    echo $port->getPort();
}

Ліміти запитів

Стандартні значення сервісу:

Клас запиту	Стандартний ліміт
`GET`	60 запитів на хвилину
`POST`, `PUT`, `PATCH`, `DELETE`	10 запитів на хвилину

У різних розгортаннях ці значення можуть відрізнятися. Вважайте 429 авторитетною відповіддю, додавайте випадкову затримку та обмежуйте паралельність. Пакетна фільтрація з pageSize: 100 ефективніша за велику кількість окремих запитів.