수집 방법 V5 (beta)
이 봇이 어떤 입력을 받는지 확인합니다.
v4 param_info의 v5 판입니다. 수집 요청·설정 변경·주기에서 inputs에 넣을 이름과 고를 수 있는 값을 알려 줍니다. 지금 저장된 값은 설정에서 읽습니다.
엔드포인트
-
GET
/v5/api/bots/{bot_id}/inputs입력 칸 정의 — 이름·형·선택지·필수 여부·엑셀 지원 여부
입력 칸 정의
요청 예시
curl 'https://www.hashscraper.com/v5/api/bots/8f3a7c1e9b5d24f6/inputs' \
-H 'Authorization: Bearer YOUR_API_KEY'
응답 예시 200
{
"result": "success",
"version": "v5",
"request_id": "req_5a8c1f1c-9b2d-4e7c-9abf-3f7e0a4d1b21",
"elapsed_sec": 0.0123,
"data": {
"bot_id": "8f3a7c1e9b5d24f6",
"excel_supported": true,
"inputs": [
{
"key": "param1",
"name": "Keyword",
"name_en": "Keyword",
"alias": "keyword",
"type": "text",
"required": true,
"options": [],
"excel_supported": true
},
{
"key": "param2",
"name": "Sort",
"name_en": "Sort",
"alias": "sort",
"type": "select",
"required": true,
"options": [
{
"name": "Popular",
"name_en": "Popular",
"value": "popular"
},
{
"name": "Newest",
"name_en": "Newest",
"value": "newest"
}
],
"excel_supported": true
}
]
}
}응답 칸
| 칸 | 설명 |
|---|---|
excel_supported | 봇 전체 값. 엑셀 올리기를 지원하는 봇인지(주의: v5 에서 엑셀로 수집하는 기능은 아직 없습니다). |
inputs[].key | param1~param10. 사용 중인 칸만 옵니다. |
name·name_en | 화면에 보이는 칸 이름(한국어·영어). 표시용이라 키로 쓰지 않습니다. |
alias | 봇에 설정한 영문 별칭, 없으면 null. paramN 대신 이 이름을 inputs의 키로 보낼 수 있습니다. |
type | 고를 수 있는 값이 있으면 select, 아니면 text. |
required | 사용 중인 칸은 모두 true. |
options | select이면 [{ name, name_en, value }]. 요청에는 value를 보냅니다. |
excel_supported | 이 칸을 엑셀 열로 채울 수 있는지. |
요청에서 쓰는 법
수집·설정·주기 요청의 inputs는 { "param1": "값" } 또는 { "keyword": "값" }(별칭) 모양입니다. 같은 칸을 paramN과 별칭으로 동시에 보내면 INVALID_PARAM, 이 봇이 쓰지 않는 칸·모르는 키도 INVALID_PARAM(details.unknown_keys)입니다. 값은 글자 또는 숫자(수집 요청에서는 null 불가)입니다.