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 상태 코드를 받게 됩니다.