Guida rapida

1. Ottieni le credenzialiCopia link alla sezione

Crea una chiave API personale in Account → Inviti → Chiavi API. Copiala quando viene mostrata e forniscila al tuo script come NINJABUY_API_KEY; mantienila riservata.

Per un’applicazione che agisce per altri clienti NinjaBuy, usa OAuth.

2. Crea link con risposta immediataCopia link alla sezione

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"}'

Fino a 100 input restituiscono 200 con results, warnings e request_id. Ogni risultato ha un input e uno status; un risultato ok include l'url con attribuzione e il code. Controlla ogni riga: il successo HTTP non significa che tutti gli input siano stati convertiti. Consulta Link.

3. Avvia un batchCopia link alla sezione

Più di 100 input vengono elaborati automaticamente in background, fino a un massimo di 2.000 per richiesta. Per provare un'operazione con un solo link, imposta async su 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 risposta è 202. Location fornisce un percorso relativo come /api/v1/jobs/JOB_ID; Retry-After: 5 indica quando interrogare l'operazione. Il corpo contiene job.id, job.status, job.total e job.poll_after_seconds.

4. Leggi i risultati tramite cursoreCopia link alla sezione

Usa l'identificatore dell'operazione presente nella risposta. Ometti cursor nella prima richiesta:

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

Per ogni richiesta successiva, passa senza modificarlo il cursore non nullo restituito:

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

Leggi i results di ogni pagina. Quando has_more è true, recupera la pagina successiva. Quando è false ma l'operazione è queued o running, attendi poll_after_seconds e interroga di nuovo con il cursore conservato. Termina dopo che l'operazione è done o failed e tutte le pagine sono state lette. Consulta Operazioni ed Errori.

Passaggi successiviCopia link alla sezione

Converti un foglio Google o un file XLSX/CSV caricato con Fogli di calcolo, oppure trova prodotti con Ricerca.