여러 유저 확인

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

POST/check_users

• 설명: 제공된 user_ids에 해당하는 사용자들이 존재하는지 확인합니다. 각 사용자에 대해 사용자가 존재하는지 여부, 사유(reason), 그리고 해당 카테고리(category)를 반환합니다.

• Arguments:

  • user_ids (array): 확인하려는 사용자 ID들의 목록. 한 번의 요청에서 최대 25개의 사용자 ID를 확인할 수 있습니다.

• Headers:

  • api_key (string): API 접근을 위한 인증 키.

  • user_id (integer): 요청하는 사용자의 ID.

• Response:

  • 200 OK

    [
      {
        "user_id": 123,
        "found": "true",
        "reason": "봇을 이용한 테러",
        "category": "도배테러"
      },
      {
        "user_id": 456,
        "found": "false",
        "reason": null,
        "category": null
      }
    ]

  • 400 Bad Request

    {
      "error": "Too many user_ids. Maximum allowed is 25."
    }

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

• 요청 예시:

  curl -X POST http://localhost:8080/check_users \
       -H "api_key: your_api_key" \
       -H "user_id: 123" \
       -d '{"user_ids": [123, 456, 789]}'

• 응답 예시 (200 OK):

  [
    {
      "user_id": 123,
      "found": "true",
      "reason": "봇을 이용한 테러",
      "category": "도배테러"
    },
    {
      "user_id": 456,
      "found": "false",
      "reason": null,
      "category": null
    }
  ]