List Tag

[ 1 HTTP Request ] [ 1.1 Parameters ] [ 2 Request Example ] [ 3 Response Example ] [ 4 Sample Code ]

이 API를 호출하면 등록된 모든 tag에 대한 정보를 반환한다. Tag_name 변수에 특정 단어를 입력하고 API를 호출하면 해당 단어를 포함하는 tag의 리스트를 반환한다. tag 수가 많아서 여러 페이지로 출력하고자 할 때에는 limit과 offset을 이용하면 된다.

HTTP Request

GET https://aws1.us.machlake.com/lakes/xbacd1234/tags
Content-Type: application/json; charset=utf8
x-api-key: {API Key}

Parameters

Optional	Type	Description	Example

Optional	Type	Description	Example
name	string	검색할 tag name 문자열 해당 문자열을 포함하는 tag 정보를 반환한다.	&name=new
limit	int	한꺼번에 표시할 갯수 0 = no limit. (Lake 생성시 설정에 따라 0일 경우에도 제한이 발생할 수 있다.)	&limit=100
offset	int	여러 페이지로 표시하기 위해 건너뛰어야 할 데이터의 수	&offset=50

Request Example

GET https://aws1.us.machlake.com/lakes/xbacd1234/tags?name=new&limit=100
Content-Type: application/json; charset=utf8
x-api-key: {API Key}

Response Example

Status 200
 
{
    "status": "success",
    "data": {
        "tag": [
            {"name": "newtag01"},
            {"name": "newtag02"}
        ]
    }
}

Sample Code

Type	Github Link

Type	Github Link
curl-bash	https://github.com/machlake/api_example/blob/main/script/linux/TagList.sh
js	https://github.com/machlake/api_example/blob/main/nodejs/TagList.js
python	https://github.com/machlake/api_example/blob/main/python/TagList.py

2022 서울시 IoT 공공도시데이터 활용 해커톤을 위한 매뉴얼

List Tag

Analytics

HTTP Request

Parameters

Request Example

Response Example

Sample Code

Related content