본문으로 건너뛰기

3. 매장 목록 조회하기

이번에는 매장 목록을 조회하는 /meta/place API를 사용하여 데이터를 가져오는 방법에 대해 알아보겠습니다.

매장 목록 조회 API

매장 목록을 조회하는 API는 다음과 같습니다.

요청

GET /meta/place/

쿼리 파라미터

search: 매장 검색어
page: 페이지 번호
page_size: 페이지당 결과 수

응답 예시

{
    "count": 100,
    "next": "https://api.mash-board.io/meta/place/?page=2",
    "previous": null,
    "results": [
        {
            "uid": "07cc67f4-45d6-494b-adac-09b5cbc7e2b5",
            "last_update": "2019-08-24T14:15:22Z",
            "tag": "mayi_tower",
            "name": "메이아이 타워",
            "open_time": "10:00:00",
            "close_time": "19:00:00",
            "collection_start": "2023-07-01",
            "collection_end": null
        }
        // ... (다른 결과들)
    ]
}

count: 전체 결과 수
next: 다음 페이지의 결과를 조회할 수 있는 링크
previous: 이전 페이지의 결과를 조회할 수 있는 링크 (현재 페이지가 첫 번째 페이지인 경우 null)
results: 조회된 매장 목록 데이터 배열

API 명세서 바로가기

예시 코드

아래는 Python을 사용하여 /meta/place API를 호출하여 매장 목록을 조회하는 예시 코드입니다. 이 코드는 MashClient 모듈을 사용합니다.

# MashClient 모듈을 사용하여 매장 목록 조회

# 클라이언트 모듈 초기화
client = MashClient()

# 사용자 인증 및 토큰 획득
client.authenticate(email="user@example.com", password="password123")

# 데이터 요청 파라미터 설정
meta_params = {
    "search": "매장1",  # 검색어 설정 (생략 가능)
}

# 데이터 요청
places_data = client.get_data(endpoint="/meta/place/", params=meta_params)

# 출력
print("Meta Data - Place List:")
print(places_data)

매장 목록 조회 API
예시 코드