Démarrage rapide

1. Obtenir les identifiantsCopier le lien de la section

Créez une clé API personnelle dans Compte → Parrainages → Clés API. Copiez-la lorsqu’elle s’affiche et fournissez-la à votre script sous le nom NINJABUY_API_KEY ; gardez-la confidentielle.

Pour une application agissant pour d’autres clients NinjaBuy, utilisez OAuth.

2. Créer des liens avec une réponse immédiateCopier le lien de la section

curl -sS https://www.ninjabuy.com/api/v1/links \
  -H "Authorization: Bearer $NINJABUY_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"links":["https://weidian.com/item.html?itemID=7581746714"],"campaign":"spring-haul","label":"video 3"}'

Jusqu'à 100 entrées renvoient 200 avec results, warnings et request_id. Chaque résultat possède un input et un status ; un résultat ok inclut l'url avec attribution et le code. Vérifiez chaque ligne : une réussite HTTP ne signifie pas que toutes les entrées ont été converties. Consultez Liens.

3. Lancer un lotCopier le lien de la section

Au-delà de 100 entrées, le traitement passe automatiquement en arrière-plan, avec un maximum de 2 000 par requête. Pour tester une tâche avec un lien, définissez async sur true :

curl -sS -D batch-headers.txt https://www.ninjabuy.com/api/v1/links \
  -H "Authorization: Bearer $NINJABUY_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"links":["https://www.ninjabuy.com/search?q=hoodie"],"async":true}'

La réponse est 202. Location indique un chemin relatif tel que /api/v1/jobs/JOB_ID ; Retry-After: 5 indique quand interroger la tâche. Le corps contient job.id, job.status, job.total et job.poll_after_seconds.

4. Lire les résultats par curseurCopier le lien de la section

Utilisez l'identifiant de tâche reçu dans cette réponse. Omettez cursor dans la première requête :

curl -sS "https://www.ninjabuy.com/api/v1/jobs/JOB_ID" \
  -H "Authorization: Bearer $NINJABUY_API_KEY"

Pour chaque requête suivante, transmettez sans modification le curseur non nul reçu :

curl -sS "https://www.ninjabuy.com/api/v1/jobs/JOB_ID?cursor=RETURNED_CURSOR" \
  -H "Authorization: Bearer $NINJABUY_API_KEY"

Lisez les results de chaque page. Lorsque has_more vaut true, récupérez la page suivante. Lorsqu'il vaut false mais que la tâche est queued ou running, attendez poll_after_seconds, puis interrogez à nouveau avec le curseur conservé. Arrêtez-vous une fois la tâche done ou failed et toutes les pages lues. Consultez Tâches et Erreurs.

Étapes suivantesCopier le lien de la section

Convertissez une feuille Google ou un fichier XLSX/CSV téléversé avec Feuilles de calcul, ou trouvez des produits avec Recherche.