/v1/request/요청 생성새 도메인 검색 요청을 생성합니다. 생성 후 요청은 처리 대기열에 추가됩니다.
| 필드 | 타입 | 설명 |
|---|---|---|
| user_description* | string | 프로젝트 설명 (5-1024자). 자세할수록 더 좋은 제안을 받을 수 있습니다. |
| zones | string[] | 선호하는 도메인 영역 목록 (예: ["com", "io"]). 선택 사항. |
| domain_max_price | integer | USD 기준 최대 도메인 가격. 선택 사항. |
curl -X POST https://api.quickname.tech/v1/request/ \
-H "Content-Type: application/json" \
-d '{
"user_description": "빈티지 시계 온라인 마켓플레이스",
"zones": ["com", "io", "tech"],
"domain_max_price": 100
}'{
"id": "123e4567-e89b-12d3-a456-426614174000",
"user_description": "빈티지 시계 온라인 마켓플레이스",
"zones": ["com", "io", "tech"],
"domain_max_price": 100,
"status": "created",
"results": [],
"is_valid": true
}/v1/request/{'{'}request_id{'}'}/요청 상태 조회처리 상태 및 결과를 포함한 도메인 검색 요청의 현재 상태를 반환합니다.
curl https://api.quickname.tech/v1/request/123e4567-e89b-12d3-a456-426614174000/{
"id": "123e4567-e89b-12d3-a456-426614174000",
"user_description": "빈티지 시계 온라인 마켓플레이스",
"zones": ["com", "io", "tech"],
"status": "finished",
"results": [
{
"domain": "techmarket.io",
"price": 45,
"availability": "available",
"reasoning": "기술 마켓플레이스를 위해 'tech'와 'market'을 결합"
}
],
"is_valid": true
}| 필드 | 타입 | 설명 |
|---|---|---|
| domain | string | 전체 도메인 이름 (예: example.com) |
| price | integer | null | USD 기준 도메인 가격. null일 수 있습니다. |
| availability | string | 상태: available, unavailable 또는 unknown |
| reasoning | string | null | 이 제안에 대한 AI 설명 |
| 코드 | 설명 |
|---|---|
| 400 | 유효성 검사 오류 — 요청 본문 확인 |
| 404 | 요청을 찾을 수 없거나 만료됨 (24시간) |
| 422 | 잘못된 UUID 형식 |
| 429 | 요청 제한 초과 (시간당 3개 요청) |
| 500 | 내부 서버 오류 |