카테고리별 사용자 수 조회

api 사용시 반드시 출처를 밝혀주세요...! (서포트 서버 url 포함) 저희 개발자들의 노력이 사라집니다...

GET /category_count/{category}

특정 카테고리에 속한 사용자의 총 수를 반환합니다.

category (string): 사용자가 속한 카테고리 이름.

Headers

Name	Value
api_key	(string): API 접근을 위한 인증 키
user_id	(integer): 요청하는 사용자의 ID.

Response

• 200 OK

{
  "total_category_count": 100
}

• 401 Unauthorized

{
  "error": "Invalid api_key or user_id"
}

• 403 Forbidden

{
  "error": "IP blocked due to low reputation"
}

• 429 Too Many Requests

{
  "error": "Rate limit exceeded"
}

• 500 Internal Server Error

{
  "error": "Failed to count documents"
}

Request Example

curl -X GET http://localhost:8080/category_count/기타 \
     -H "api_key: your_api_key" \
     -H "user_id: 123"

API 요청 시 주의 사항:

1. 요청 빈도 제한 (Rate Limiting):

   • 초당 최대 10회 요청: API는 초당 최대 10회의 요청만 허용됩니다. 이 한도를 초과하는 요청이 발생하면 해당 IP에 대해 레이트 리미팅이 적용됩니다.

2. IP 차단 정책:

   • 초당 요청 한도 초과 시 차단: 특정 IP에서 초당 10회를 초과하는 요청이 발생할 경우, 시스템은 해당 IP를 2시간 동안 차단합니다. 이 동안 해당 IP에서는 더 이상 API에 접근할 수 없습니다.

   • 차단 해제: 차단된 IP는 2시간이 지나야 자동으로 차단이 해제됩니다. 따라서, 초당 요청 횟수를 관리하여 IP 차단을 방지해야 합니다.