7개월 전

API : 가상모델목록

1. 개요

이 API는 가상 모델 목록을 검색하는 데 사용됩니다. 각 모델은 고유 식별자, 이름, 성별, 프로필 이미지 URL을 포함합니다.

 

2. HTTP 요청

GET https://lina.photos/request/?act=get_virtual_model_list

 

3. 요청 매개변수

이 API는 URL 쿼리 매개변수를 사용합니다:

매개변수 설명 필수 여부
act get_virtual_model_list API 동작을 지정
mid request 모듈 식별자

 

4. 응답 형식

응답은 JSON 형식으로 반환됩니다. 기본 구조는 다음과 같습니다:


  

{ "request": { "act": "String", "mid": "String" }, "data": [ { "member_srl": "Integer", "name": "String", "gender": "String", "profile_image": "URL" }, ... ] }

 

5. 데이터 설명

  • request: 요청에 사용된 매개변수를 포함하는 객체입니다.
    • act (String): 수행된 작업을 나타냅니다.
    • mid (String): 요청을 처리하는 모듈의 식별자입니다.
  • data: 모델 정보 배열. 각 객체는 다음 필드를 포함합니다:
    • member_srl (Integer): 모델의 고유 식별자.
    • name (String): 모델의 이름.
    • gender (String): 모델의 성별 ("여자" 또는 "남자").
    • profile_image (URL): 모델의 프로필 이미지 주소.

 

6. 응답 예시


  

{ "request": { "act": "get_virtual_model_list", "mid": "request" }, "data": [ { "member_srl": 1681, "name": "리나", "gender": "여자", "profile_image": "https://lina.photos/files/member_extra_info/profile_image/681/001/1681.png?t=1714618583" } // 추가 모델 데이터... ] }

 

7. 에러 처리

API 요청이 실패하거나 잘못된 매개변수가 제공될 경우, 클라이언트는 에러 메시지와 함께 적절한 HTTP 상태 코드를 받게 됩니다.

31
0
댓글이 없습니다.