BigdataTensorFlow
TensorFlow
TensorFlow Recommenders (TFRS)는 TensorFlow 기반의 라이브러리로, 협업 필터링(Collaborative Filtering) 기반의 추천 시스템을 구축하기 위해 설계되었습니다. TFRS는 TensorFlow에서 제공하는 기능과 모델을 활용하여 사용자-아이템 상호작용 데이터를 분석하고, 사용자와 아이템 간의 관계를 학습하여 추천을 수행하는데 사용됩니다.
공통 설정
인증키 발급
인증 토근 발급받기 위한 계정 생성 이름, 이메일, 패스워드 입력 후 계정을 생성 해야만 정상적으로 사용이 가능합니다.
토큰 발급을 위한 로그인
이메일 / 패스워드 입력 토큰 값 발급 후 인증 통해 정상적으로 API 를 이용 하실 수 있습니다.
발급 토큰 유효
토큰은 발급 1시간 후 자동 파기 됩니다. 재발급 받으셔야 정상 이용 가능합니다.
API URL
| Method | Request URI |
|---|---|
GET | /recommend/api/v1.0/subject |
요청 헤더
| 헤더명 | 설명 |
|---|---|
| Authorization | 로그인 또는 회원 가입 후 발급 받은 토큰키 입력 Bearer [토큰값] |
| Content-Type | application/json |
요청 파라미터
| 파라미터 이름 | 타입 | 설명 | 기본값 | 필수 여부 |
|---|---|---|---|---|
| user_id | string | 추천 강의 요청 학생 인덱스 키값 | N | Y |
| mod | string | (기본은 null) 값이 없을 경우 학습 요청 추천강의 초기화 할 경우 | null | N |
응답 바디
| 필드 이름 | 타입 | 설명 |
|---|---|---|
| data | Array of Object | 학습을 통한 추천강의 목록 |
| data.course | String | 추천 강의명 |
| data.code | String | 추천 강의 코드 |
| data.score | Integer | 추천 강의 스코어 |
오류 코드
# JSON
{
"error": {
"errorCode": "300",
"message": "Not Found Exception"
}
}공통 오류
| HttpStatusCode | ErrorCode | ErrorMessage | Description |
|---|---|---|---|
| 400 | 100 | Bad Request Exception | protocol(https), endocing(UTF-8) 등 |
| 401 | 200 | Authentication Failed | 인증실패 |
| 401 | 210 | Permission Denied | 권한없음 |
| 404 | 300 | Not Found Exception | 권한없음 |
| 429 | 400 | Quota Exceeded | Quota 초과 |
| 429 | 410 | Throttle Limited | Rate 초과 |
| 429 | 420 | Rate Limited | Rate 초과 |
| 413 | 430 | Request Entity Too Large | content-length 초과 (10MB) |
| 503 | 500 | Endpoint Error | 엔드포인트 연결오류 |
| 504 | 510 | Endpoint Timeout | 엔드포인트 연결시간 초과 |
| 500 | 900 | Unexpected Error | 예외처리가 안된 오류 |
Swagger 문서
Swagger 바로가기Was this helpful?
Prev