AI 튜토리얼

Zad Top HTTP API로 리셀러 워크플로 구축하기

Zad Top HTTP API 연결 및 요청 인증 방법, 플레이어용 코드 사용, 사용 전 카드 확인, 플레이어 세부 정보 조회, 문서화된 엔드포인트를 통한 리셀러 재고 관리 방법을 알아보세요.

2026년 11월 5일약 11분 소요

Zad Top은 리셀러, 상점, 패널 및 맞춤형 봇을 위한 독립적인 Telegram 봇이자 HTTP API입니다. Free Fire, PUBG Mobile, Yalla Ludo, Jawaker, iTunes, Razer Gold 서비스를 제공하며, 코드 사용, 카드 확인, 플레이어 조회, 재고 사용 및 주문 스크린샷 기능을 지원합니다.

이 저장소는 봇 소스 코드가 아닌 공개 개발자 허브입니다. 실시간 API 문서는 api.zadtop.com/docs에서 확인할 수 있으며, 대화형 Swagger 인터페이스와 OpenAPI 문서도 제공됩니다.

만들 수 있는 것

Zad Top을 사용하면 플레이어 ID로 디지털 코드를 보내고, 사용 전에 지원되는 카드를 확인하며, 게임 내 플레이어 이름과 지역을 조회하고, 저장된 재고에서 상품을 사용하는 리셀러 워크플로를 만들 수 있습니다. 사용이 완료된 후 상점 주문 이미지를 요청할 수도 있습니다.

Free Fire, PUBG Mobile UC, Yalla Ludo 다이아몬드 및 골드, Jawaker 토큰을 사용합니다.
지원되는 Free Fire, PUBG, Yalla Ludo 다이아몬드, iTunes 및 Razer Gold 카드를 확인합니다.
Razer Gold PIN을 본인 지갑에 충전합니다.
코드를 사용하기 전에 플레이어의 게임 내 이름과 지역을 조회합니다.
봇에 코드를 저장하고 개별 코드를 제출하는 대신 재고 팩을 사용합니다.
상점 워크플로를 위한 주문 스크린샷을 가져옵니다.

액세스 및 인증 준비

HTTP API를 사용하려면 Telegram에서 @ZadTopBot을 열고 Subscription을 선택한 다음 HTTP API를 선택합니다. 활성 요금제와 HTTP API 애드온이 필요합니다. README에는 애드온 요금이 30일에 15 USDT로 안내되어 있습니다. 별도의 Code checking 구독만으로도 확인 라우트를 호출할 수 있습니다.

API 키를 발급받은 후 인증이 필요한 모든 요청의 X-API-Key 헤더에 키를 전송합니다.

X-API-Key: pk_YOUR_KEY

GitHub에서 Zad Top에 별표 표시하기

새 키를 만들면 이전 키가 폐기되므로 인증 정보를 교체할 때마다 애플리케이션 설정을 업데이트해야 합니다. 키는 서버에 보관하고 브라우저 측 코드나 공개 저장소에 노출하지 마세요.

첫 번째 즉시 사용 요청 만들기

POST /v1/jobs/instant-redeem 라우트는 플레이어 ID에 하나 이상의 코드를 사용합니다. 요청은 JSON을 사용하며 API 키와 콘텐츠 유형 헤더가 필요합니다.

curl -sS -X POST https://api.zadtop.com/v1/jobs/instant-redeem \
  -H "X-API-Key: pk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"player_id":"2186053213","codes":["4233939008625064"],"game":"freefire"}'

이 예시의 game 값은 freefire입니다. 그 밖에 지원되는 값으로는 pubg, ludo, ludogold, jawaker, razer_recharge 및 API 문서에 설명된 기타 서비스별 값이 있습니다.

사용 요청은 작업으로 처리됩니다. 작업이 done에 도달했다는 것은 처리가 끝났다는 뜻이지만, 제출한 각 코드에는 고유한 success 결과와 해당하는 경우 err_code가 있습니다. 작업이 완료되었다고 해서 모든 코드가 성공했다고 간주하지 마세요.

작업 및 결과 추적

GET /v1/jobs/{id}를 사용하여 작업 상태와 결과를 가져옵니다. 즉시 폴링하는 대신 ?wait=25를 추가하여 지정된 시간만큼 기다릴 수 있습니다.

curl -sS "https://api.zadtop.com/v1/jobs/JOB_ID?wait=25" \
  -H "X-API-Key: pk_YOUR_KEY"

Zad Top — Telegram 코드 사용 봇 및 HTTP API

실용적인 통합에서는 작업 ID를 저장하고 작업 결과를 요청한 다음 각 코드 수준의 결과를 모두 확인해야 합니다. 성공한 코드와 실패한 코드를 고객 또는 리셀러 대시보드에 별도로 표시하세요.

사용 전에 코드 확인

POST /v1/codes/check 라우트는 카드를 사용하지 않고 최대 20장까지 확인합니다. 더 큰 배치에는 작업 방식으로 최대 10,000장의 카드를 지원하는 POST /v1/jobs/code-check를 사용하세요.

지원되는 결과는 게임에 따라 다릅니다. Free Fire는 미사용, 사용됨 또는 유효하지 않음 상태를 반환할 수 있으며 팩 정보가 포함될 수도 있습니다. PUBG는 미사용, 사용됨, 만료 또는 유효하지 않음 상태를 반환할 수 있으며 상점에서 값을 알고 있는 경우 해당 값이 포함될 수 있습니다. Yalla Ludo 다이아몬드는 확인할 수 있지만 골드에는 확인 라우트가 없습니다. 골드 코드를 다이아몬드 확인기에 보내면 사용될 수 있으므로 제출하기 전에 상품 유형을 확인하세요.

iTunes 확인 결과에는 달러 잔액이 표시됩니다. 일정 시간 동안 사용하지 않은 후 처음 조회할 때는 최대 1분이 걸릴 수 있습니다. Razer Gold 확인은 PIN을 사용하지 않고 활성, 사용됨 또는 유효하지 않음 상태를 반환하지만, README에는 PIN당 요청 한도가 5회로 지정되어 있습니다.

먼저 플레이어 조회

사용하기 전에 GET /v1/player/lookup을 호출하여 게임 내 이름과 지역을 가져옵니다. 이를 통해 유효한 코드를 잘못된 플레이어 ID로 보내는 일을 방지할 수 있습니다.

curl -sS "https://api.zadtop.com/v1/player/lookup?player_id=2186053213&game=freefire" \
  -H "X-API-Key: pk_YOUR_KEY"

반환된 사용자 식별 정보를 사용자 인터페이스에서 확인 단계로 사용하세요. README에는 선택한 플레이어 ID에 대한 책임이 사용자에게 있으며, 유효한 코드는 상점과 처음 성공적으로 연락할 때 전송된 계정에 충전된다고 명시되어 있습니다.

즉시 사용

재고 사용 처리

Zad Top에서 재고를 관리한다면 모든 주문에 코드를 붙여 넣는 대신 POST /v1/jobs/stock-redeem을 사용해 저장된 재고에서 사용 처리하세요. GET /v1/stock/summary 경로는 게임 및 상품 묶음별 재고를 보여 줍니다.

curl -sS https://api.zadtop.com/v1/stock/summary \
  -H "X-API-Key: pk_YOUR_KEY"

정확한 재고 사용 처리 필드와 상품 묶음 식별자는 최신 참조 문서 또는 저장소의 엔드포인트 안내에서 확인해야 합니다. 이를 통해 사용 가능한 재고 카테고리에 대한 가정을 코드에 하드코딩하는 일을 피할 수 있습니다.

게임별 고려 사항

Free Fire: 사용 처리 및 확인을 지원합니다.
PUBG Mobile: UC 사용 처리 및 확인을 지원합니다.
Yalla Ludo: 상황에 따라 ludo 또는 ludogold를 사용하세요. 사용 처리에는 tier가 필요합니다. 다이아몬드는 확인할 수 있지만 Gold는 확인할 수 없습니다.
Jawaker: 사용 처리를 지원하지만 12자리 PIN을 독립적으로 확인하는 기능은 없습니다.
iTunes: 등록된 서비스를 통한 잔액 확인만 지원하며, 비활성 상태 이후의 첫 요청은 최대 1분이 걸릴 수 있습니다.
Razer Gold: PIN을 사용하지 않고 확인할 수 있습니다. razer_recharge 작업은 PIN을 지갑에 충전하며 이메일 주소와 비밀번호가 필요합니다. 비밀번호는 저장되지 않습니다.

계정 및 상점 작업 추가

API는 계정 및 리셀러용 경로도 제공합니다.

계정 정보를 위한 GET /v1/me
사용량 한도 정보를 위한 GET /v1/quota
작업 내역을 위한 GET /v1/history
저장된 플레이어를 위한 GET /v1/players
사용 처리 성공 후 상점 주문 이미지를 위한 POST /v1/order/screenshot

사용 전에 코드 확인

이러한 경로는 관리 대시보드를 지원할 수 있으며, 작업 및 조회 경로는 고객용 주문 흐름을 구현하는 데 사용할 수 있습니다.

한도 및 사용 비용 이해

README에 따르면 사용 처리에는 코드당 요청 1회, 확인에는 카드당 요청 1회가 사용되며, Razer Gold 확인에는 PIN당 요청 5회가 사용됩니다. 플레이어 조회에는 요청 0.25회가 사용됩니다. 상점 거부와 결과가 반환되기 전 발생한 실패도 문서화된 사용량 규칙에 따라 집계됩니다.

일일 한도는 UTC 자정에 초기화되며, 요금제에 포함된 게임, Telegram 봇 및 API가 한도를 공유합니다. 신규 계정에는 무료 사용 처리 10회가 제공됩니다. 요금제 가격과 이용 가능 여부는 변경될 수 있으므로 결제 흐름을 구축하기 전에 봇 또는 공식 사이트에서 현재 약관을 확인하세요.

권장 통합 흐름

플레이어의 게임, 플레이어 ID, 상품 및 코드를 수집합니다.
플레이어 조회 엔드포인트를 호출하고 반환된 이름과 지역을 확인용으로 표시합니다.
지원되는 상품의 경우 사용 처리 전에 코드를 확인합니다.
즉시 사용 처리 또는 재고 사용 처리 작업을 제출합니다.
/v1/jobs/{id}를 폴링하거나 wait 매개변수를 사용합니다.
전체 작업 상태와 각 코드의 success 및 err_code 필드를 확인합니다.
고객에게 명확한 결과를 표시하고 필요에 따라 주문 스크린샷을 요청합니다.

고급 구현 팁

자격 증명 보호

API 키를 서버 측 환경 변수 또는 보안 비밀 관리 시스템에 저장하세요. 모바일 애플리케이션, 프론트엔드 JavaScript, 로그 또는 고객 지원용 스크린샷에 키를 포함하지 마세요.

게임 및 카드

비동기 처리에 맞게 설계

사용 처리 및 일괄 확인 작업은 작업으로 처리됩니다. 작업 식별자를 저장하고 안전한 상태 조회를 위한 재시도를 지원하며, 전송 오류와 코드 수준의 실패를 구분하세요. 작업이 done 상태가 되어도 개별 결과를 확인해야 합니다.

상품과 게임 조합 검증

애플리케이션에서 명시적인 상품 매핑을 사용하여 다이아몬드, Gold, UC 및 기타 상품이 잘못된 경로나 확인 기능으로 실수로 전송되지 않도록 하세요. Gold는 확인 기능이 없고 부적절한 확인 요청으로 사용될 수 있는 Yalla Ludo에서 특히 중요합니다.

지연 시간과 할당량 고려

iTunes 잔액 조회와 일괄 작업에는 추가 시간을 허용하세요. 특히 Razer 확인의 경우 PIN 하나로 요청 5회가 사용될 수 있으므로 할당량 사용량을 로컬에서 추적하세요. 봇과 API 활동이 일일 공유 한도를 함께 사용한다는 점도 고려해야 합니다.

결론

Zad Top은 디지털 게임 및 기프트 카드 리셀러 업무를 위한 특화 API를 제공합니다. API 액세스와 X-API-Key 헤더로 시작하고, 플레이어 신원을 확인하며, 지원되는 경우 확인 기능을 사용하고, 사용 처리 작업을 제출한 다음 각 코드 수준의 결과를 평가하세요. 엔드포인트 세부 정보와 현재 서비스 동작은 HTML API 참조, Swagger 문서 및 프로젝트의 GitHub 저장소를 확인하세요.

Zad Top은 독립적인 서비스이며 Garena, Krafton, Tencent, Yalla Games, Apple, Razer 또는 Jawaker와 제휴 관계가 없습니다.