API : 결과 이미지 보기
1. 개요
이 API는 특정 문서(document_srl
)에 대한 처리 결과를 조회합니다. 사용자는 문서 일련번호를 기반으로 이미지 URL과 다양한 결과 데이터를 받을 수 있습니다.
2. HTTP 요청
GET https://lina.photos/result/?act=get_result&document_srl=144145
3. 요청 매개변수
매개변수 | 값 | 설명 | 필수 여부 |
---|---|---|---|
act | get_result | API 행동을 지정합니다. | 예 |
document_srl | 144145 | 결과를 조회할 문서의 일련번호 | 예 |
mid | result | 모듈 식별자 | 예 |
4. 응답 형식
응답은 JSON 형식으로 반환되며, 다음과 같은 필드를 포함합니다:
{ "request": { "act": "String", "document_srl": "String", "mid": "String" }, "data": { "uid": "Integer", "image_url": "URL", "result_url": "URL" }, "result_list": [ { "result_url": "URL", "is_use": "String" }, ... ] }
5. 데이터 설명
- request: 요청에 사용된 매개변수를 포함하는 객체입니다.
- act, document_srl, mid: 각각 요청의 종류, 문서 번호, 모듈 식별자를 나타냅니다.
- data: 메인 결과 데이터를 포함합니다.
- uid: 사용자 ID.
- image_url: 원본 이미지 URL.
- result_url: 주 결과 이미지 URL.
- result_list: 추가 결과 이미지 목록, 각 객체는 다음을 포함합니다.
- result_url: 결과 이미지 URL.
- is_use: 이미지 사용 여부('y'는 사용 중, 'n'은 사용 안 함).
6. 성공 응답 예시
{ "request": { "act": "get_result", "document_srl": "144145", "mid": "result" }, "data": { "uid": 130545, "image_url": "https://lina.photos/files/attach/images/2024/03/28/5ef893b8dcda5d92b533b117ab0fccbd.jpg", "result_url": "https://artbang001.s3.ap-northeast-2.amazonaws.com/sd/130545-20240328061427.jpg" }, "result_list": [ ... ] }
7. 오류 처리
- 400 Bad Request: 필요한 매개변수가 누락되었거나 잘못된 경우.
- 404 Not Found: 지정된
document_srl
에 해당하는 문서가 없는 경우. - 500 Internal Server Error: 서버 내부 오류 발생.