Пачынаючы

Стварыць асобны токен для кожнай інтэграцыі. Затым вы можаце адклікаць адно злучэнне, не перарываючы іншыя і даць толькі дазволы, якія ён мае патрэбу.

Захоўваць токен у серверных сакрэтах. ніколі не адпраўляць яго ў браўзэры JavaScript, мабільнае прыкладанне, URL, часопісы або аналітыкі.

curl --request GET 'https://api.selsup.ru/api/brand/find?limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

Прыкладанне error звычайна ўтрымлівае error, localMessage і params. Сервер перакладае localMessage з дапамогай поля lang карыстальніка, які валодае токеном.

Мова дакументацыі і Accept-Language не змяняюць месцазнаходжанне error. Ніколі не параўноўвайце localMessage ў кодзе або захавайце яго ў якасці статусу машыны.

{
  "error": "brand_already_exists",
  "localMessage": "Brand Base already exists",
  "params": {
    "name": "Base"
  }
}

count=true можа выклікаць дадатковы запыт ліку. Адправіць яго на першым запыце толькі тады, калі агульная фактычна неабходна.

Дадзеныя могуць змяняцца паміж старонкамі. Для паўторнай сінхранізацыі, сартаваць па непераменным ідэнтыфікатары і працэсу змены ў асобным паведамленні павелічэння.

let page = 1;
let hasNextPage = true;

while (hasNextPage) {
  const url = new URL('https://api.selsup.ru/api/brand/find');
  url.searchParams.set('limit', '500');
  url.searchParams.set('page', String(page));
  url.searchParams.set('sortBy', 'BRANDID');
  url.searchParams.set('ascending', 'true');

  const response = await fetch(url, {
    headers: { Authorization: process.env.SELSUP_API_TOKEN }
  });
  if (!response.ok) throw await response.json();

  const result = await response.json();
  await savePage(result.rows);
  hasNextPage = result.hasNextPage;
  page += 1;
}

1. 1

   Асобнае чытанне і пісьмо

   Па-першае, пацвердзіце запыты GET. Выкарыстоўвайце тэставыя суб'екты і выразны крок пацвярджэння для мутацый.

2. 2

   Канфігуруйце часы і паўторныя спробы

   Звярніце ўвагу на няўдалы сеткі і бяспечныя аперацыі толькі. POST без вашага ўласнага ключ адмоўнасці можа стварыць дублікат.

3. 3

   Абмежаванне адначасовасці

   Выконвайце межы канчатковага пункту і выкарыстоўвайце чаргу з экспаненцыйным адступленнем і невялікім выпадковым дрыжтам.

4. 4

   Вынікі пагадзіцца

   Пасля шэрагу сінхронізацыі, параўноўвайце лічбы і ўзоры ідэнтыфікатараў, а затым перамясціце непарыўнасці ў асобную чаргу.