Je commence

Créer un jeton séparé pour chaque intégration. Vous pouvez ensuite révoquer une connexion sans interrompre les autres et accorder uniquement les autorisations dont elle a besoin.

Gardez le jeton dans des secrets du côté du serveur. Ne jamais l'envoyer dans le navigateur JavaScript, une application mobile, une URL, des journaux ou des analyses.

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

Une application error contient normalement error, localMessage et params. Le serveur traduit XPRO TECTED4X en utilisant le champ lang de l'utilisateur qui possède le jeton.

Le langage de documentation et Accept-Language ne modifient pas la localisation error. Ne jamais comparer localMessage dans le code ou le maintenir comme un état de machine.

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

count=true peut déclencher une requête de comptage supplémentaire. Envoyez-la sur la première demande seulement lorsque le total est réellement nécessaire.

Les données peuvent changer entre les pages. Pour une synchronisation récurrente, trier par un identifiant immutable et les changements de processus dans un flux incrémentiel séparé.

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

   Lire et écrire séparément

   Valider d'abord les demandes GET. Utilisez des entités de test et une étape de confirmation explicite pour les mutations.

2. 2

   Configurer les délais et les retries

   Une POST sans votre clé d'idempotence peut créer un duplicate.

3. 3

   Limiter la concurrentialité

   Respectez les limites des points d'extrémité et utilisez une file d'attente avec un back-off exponentiel et un petit jitter aléatoire.

4. 4

   Concilier les résultats

   Après une synchronisation en masse, comparez les nombres et les identifiants d'échantillon, puis déplacez les divergences dans une file d'attente séparée.