6개월 전

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: 서버 내부 오류 발생.

 

 

56
0
댓글이 없습니다.