빠른 시작

1. 인증 정보 받기섹션 링크 복사

계정 → 친구 초대 → API 키에서 개인 API 키를 생성하세요. 표시될 때 복사하여 스크립트에 NINJABUY_API_KEY로 전달하고 비공개로 보관하세요.

다른 NinjaBuy 고객을 대신해 작동하는 애플리케이션에는 OAuth를 사용하세요.

2. 링크 즉시 생성하기섹션 링크 복사

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

입력이 100개 이하이면 results, warnings, request_id를 포함하는 200이 반환됩니다. 각 결과에는 input과 status가 있으며, ok 결과에는 추천 실적이 기록되는 링크의 url과 code가 포함됩니다. 모든 행을 확인하세요. HTTP 성공이 모든 입력의 변환 성공을 뜻하지는 않습니다. 링크를 확인하세요.

3. 일괄 처리 시작하기섹션 링크 복사

입력이 100개를 초과하면 자동으로 백그라운드에서 실행되며, 요청당 최대 2,000개까지 가능합니다. 링크 하나로 작업을 시험하려면 async를 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}'

응답은 202입니다. Location은 /api/v1/jobs/JOB_ID 같은 상대 경로를 제공하며, Retry-After: 5는 다음 조회 시점을 알려줍니다. 본문에는 job.id, job.status, job.total, job.poll_after_seconds가 포함됩니다.

4. 커서로 결과 읽기섹션 링크 복사

응답의 작업 ID를 사용하세요. 첫 요청에서는 cursor를 생략하세요.

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

이후 각 요청에서는 반환된 null이 아닌 커서를 변경 없이 전달하세요.

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

각 페이지의 results를 읽으세요. has_more가 true이면 다음 페이지를 가져오세요. False지만 작업이 queued 또는 running이면 poll_after_seconds만큼 기다린 후 보관한 커서로 다시 조회하세요. 작업이 done 또는 failed이고 모든 페이지를 읽은 후 종료하세요. 작업 및 오류를 확인하세요.

다음 단계섹션 링크 복사

시트로 Google Sheet나 업로드한 XLSX/CSV를 변환하거나 검색으로 상품을 찾으세요.