|
1. Request
parameter | type | description |
keyword | string (not null) | 검색어 (utf-8 encoding) |
sr | string (not null) | 검색대상 (default:artist, range:artist,album,song) |
display | integer (not null) | 검색결과 출력건수 (default:10, range:1~100) |
key | string (not null) | api key |
v | string (not null) | api version (default:0.5) |
1. api key 는 당분간 validation check를 하진 않습니다.
본인의 이메일을 key 로 사용하고 계시면, 정책 변경시 연락 드리겠습니다.
언제 정책이 바뀔지 모르므로, 연락이 닿지 않을 경우 예고 없이 사용이 중단될 수 있습니다.
2. 아래 CCL 의 조건을 준수하여 사용하시면 되고, 상업적 사용의 경우 이메일로 연락 바랍니다.
2. Response (XML)
parameter | type | description |
rss | string | 디버그를 쉽게 하고 RSS 리더기만으로 이용할 수 있게 하기 위해 만든 RSS 포맷의 컨테이너이며 그 외의 특별한 의미는 없습니다. |
... channel | string | 검색 결과를 포함하는 컨테이너입니다. 이 안에 있는 title, link 등의 항목은 참고용으로 무시해도 무방합니다. |
... ... lastBuildDate | datetime | 검색 결과를 생성한 시간입니다. RFC1123 포멧으로 되어 있습니다. |
... ... total | integer | 검색 결과 문서의 총 개수를 의미합니다. |
... ... start | integer | 검색 결과 문서 중, 문서의 시작점을 의미합니다. 현재는 1로 고정되어 있습니다. |
... ... display | integer | 검색된 검색 결과의 개수입니다. |
... ... item | - | 개별 검색 결과이며, title, link을 포함합니다. |
... ... ... | - | 귀찮아서 정리하지 못했습니다. 예제를 보세요. |
1. Request
parameter | type | description |
album_id | string (not null) | maniadb album_id |
key | string (not null) | api key |
v | string (not null) | api version (default:0.5) |
2. Response (XML)
parameter | type | description |
rss | string | 디버그를 쉽게 하고 RSS 리더기만으로 이용할 수 있게 하기 위해 만든 RSS 포맷의 컨테이너이며 그 외의 특별한 의미는 없습니다. |
... channel | string | 앨범 정보를 포함하는 컨테이너입니다. 이 안에 있는 title, link 등의 항목은 참고용으로 무시해도 무방합니다. |
... ... lastBuildDate | datetime | 앨범 정보를 생성한 시간입니다. RFC1123 포멧으로 되어 있습니다. |
... ... item | - | 앨범 정보를 보여주는 컨테이너로, 하나만 존재합니다. title, link을 포함합니다. 파라메터 id는 maniadb album_id를 의미합니다. |
... ... ... | - | 귀찮아서 정리하지 못했습니다. 예제를 보세요. |
1. Request
요청 변수 |
|
값 |
|
설명 |
key |
|
string (필수) |
|
이용 등록을 통해 받은 key 스트링을 입력합니다. |
target |
|
string (필수) |
|
music |
itemtype |
|
string (필수) |
|
검색 대상 : album, artist |
query |
|
string |
|
검색어 : UTF-8 인코딩 입니다. |
display |
|
integer : 기본값 10, 최대 100 |
|
검색결과 출력건수 : 최대 100까지 가능합니다. |
2. Response (XML)
요청 변수 |
|
값 |
|
설명 |
rss |
|
- |
|
디버그를 쉽게 하고 RSS 리더기만으로 이용할 수 있게 하기 위해 만든 RSS 포맷의 컨테이너이며 그 외의 특별한 의미는 없습니다. |
... channel |
|
- |
|
검색 결과를 포함하는 컨테이너입니다. 이 안에 있는 title, link 등의 항목은 참고용으로 무시해도 무방합니다. |
... ... lastBuildDate |
|
datetime |
|
검색 결과를 생성한 시간입니다. RFC1123 포멧으로 되어 있습니다. |
... ... total |
|
integer |
|
검색 결과 문서의 총 개수를 의미합니다. |
... ... start |
|
integer |
|
검색 결과 문서 중, 문서의 시작점을 의미합니다. 현재는 1로 고정되어 있습니다. |
... ... display |
|
integer |
|
검색된 검색 결과의 개수입니다. |
... ... item |
|
- |
|
개별 검색 결과이며, title, link을 포함합니다. |
3-1. 출력 결과 필드 : ALBUM
문서를 귀찮아서 안 만들었습니다. 틈나는대로 만들께요. 일단 예제를 보세요.
- (호출예)
http://www.maniadb.com/api/search.asp?key=example&target=music&v=0.4&itemtype=album&query=metallica
3-2. 출력 결과 필드 : SONG
아직 못 만들었습니다.
- (호출예)
http://www.maniadb.com/api/search.asp?key=example&target=music&v=0.4&itemtype=song&query=metallica
3-3. 출력 결과 필드 : ARTIST
문서를 귀찮아서 안 만들었습니다. 틈나는대로 만들께요. 일단 예제를 보세요.
- (호출예)
http://www.maniadb.com/api/search.asp?key=example&target=music&v=0.4&itemtype=artist&query=metallica
1. Request
요청 변수 |
|
값 |
|
설명 |
key |
|
string (필수) |
|
이용 등록을 통해 받은 key 스트링을 입력합니다. |
target |
|
string (필수) |
|
서비스를 위해서는 무조건 지정해야 합니다. ex) music, ... |
itemtype |
|
string (필수) |
|
서비스를 위해서는 무조건 지정해야 합니다. ex) album, song, artist, ... |
option |
|
string (필수) |
|
검색 기준을 선택합니다. ex) album, song, artist, ... |
query |
|
string |
|
검색을 원하는 앨범의 이름, UTF-8 인코딩 입니다. |
option2 |
|
string |
|
두번째 검색 기준을 선택합니다. ex) artist, .... |
query2 |
|
string |
|
검색을 원하는 아티스트의 이름, UTF-8 인코딩 입니다. |
display |
|
integer : 기본값 10, 최대 100 |
|
검색결과 출력건수를 지정합니다. 최대 100까지 가능합니다. |
2. Response (XML)
요청 변수 |
|
값 |
|
설명 |
rss |
|
- |
|
디버그를 쉽게 하고 RSS 리더기만으로 이용할 수 있게 하기 위해 만든 RSS 포맷의 컨테이너이며 그 외의 특별한 의미는 없습니다. |
... channel |
|
- |
|
검색 결과를 포함하는 컨테이너입니다. 이 안에 있는 title, link 등의 항목은 참고용으로 무시해도 무방합니다. |
... ... lastBuildDate |
|
datetime |
|
검색 결과를 생성한 시간입니다. RFC1123 포멧으로 되어 있습니다. |
... ... total |
|
integer |
|
검색 결과 문서의 총 개수를 의미합니다. |
... ... start |
|
integer |
|
검색 결과 문서 중, 문서의 시작점을 의미합니다. 현재는 1로 고정되어 있습니다. |
... ... display |
|
integer |
|
검색된 검색 결과의 개수입니다. |
... ... item |
|
- |
|
개별 검색 결과이며, title, link을 포함합니다. |
요청 변수 |
|
값 |
|
설명 |
... ... item |
|
- |
|
개별 검색 결과이며, title, link을 포함합니다. 파라메터 id는 maniadb album_id를 의미합니다. |
... ... ... title |
|
string |
|
앨범 제목을 나타냅니다. |
... ... ... release |
|
string |
|
앨범 발매일자를 char(8) 형태로 나타냅니다. |
... ... ... link |
|
string |
|
앨범 링크를 나타냅니다. |
... ... ... image |
|
string |
|
앨범 커버를 나타냅니다. 최대 800x800으로 구성됩니다. |
... ... ... description |
|
string |
|
앨범 소개글이 나타냅니다. 최대 100글자로 구성됩니다. |
... ... ... maniadb:artist |
|
- |
|
앨범의 대표 아티스트 정보를 나타냅니다. |
... ... ... ... link |
|
string |
|
앨범의 아티스트 링크를 나타냅니다. |
... ... ... ... name |
|
string |
|
앨범 아티스트의 이름을 나타냅니다. |
- (호출예)
http://www.maniadb.com/api/search.asp?key=example&target=music&v=0.3&itemtype=album&option=album&query=best&option2=artist&query2=leejung
요청 변수 |
|
값 |
|
설명 |
... ... item |
|
- |
|
개별 검색 결과이며, title, link을 포함합니다. 파라메터 id는 maniadb song_id를 의미합니다. |
... ... ... title |
|
string |
|
노래 제목을 나타냅니다. |
... ... ... runningtime |
|
string |
|
노래 길이를 "분:초" 형태로 나타냅니다. |
... ... ... link |
|
string |
|
노래 링크를 나타냅니다. |
... ... ... description |
|
string |
|
가사 일부가 나타납니다. 최대 100글자로 구성됩니다. |
... ... ... maniadb:album |
|
- |
|
노래 수록 앨범의 정보를 나타냅니다. |
... ... ... ... title |
|
string |
|
노래 수록 앨범의 제목을 나타냅니다. |
... ... ... ... release |
|
string |
|
노래 수록 앨범의 발매일자를 나타냅니다. |
... ... ... ... link |
|
string |
|
노래 수록 앨범의 아티스트 링크를 나타냅니다. |
... ... ... ... image |
|
string |
|
노래 수록 앨범 커버를 나타냅니다. 최대 800x800으로 구성됩니다. |
... ... ... ... description |
|
string |
|
노래 수록 앨범 소개글이 나타냅니다. 최대 100글자로 구성됩니다. |
... ... ... maniadb:artist |
|
- |
|
앨범의 대표 아티스트 정보를 나타냅니다. |
... ... ... ... link |
|
string |
|
노래의 아티스트 링크를 나타냅니다. |
... ... ... ... name |
|
string |
|
노래 아티스트의 이름을 나타냅니다. |
- (호출예)
http://www.maniadb.com/api/search.asp?key=example&target=music&v=0.3&itemtype=song&option=song&query=love&option2=artist&query2=beatles
요청 변수 |
|
값 |
|
설명 |
... ... item |
|
- |
|
개별 검색 결과이며, title, link을 포함합니다. 파라메터 id는 maniadb artist_id를 의미합니다. |
... ... ... title |
|
string |
|
아티스트 대표 이름을 나타냅니다. |
... ... ... reference |
|
string |
|
아티스트 참조어를 나타냅니다. 주로 동명이인 구분에 쓰입니다. |
... ... ... demographic |
|
string |
|
아티스트 셩별 및 구분(솔로/그룹 여부)을 나타냅니다. |
... ... ... period |
|
string |
|
아티스트 활동 시기를 나타냅니다. |
... ... ... link |
|
string |
|
아티스트 링크를 나타냅니다. |
... ... ... image |
|
string |
|
아티스트 대표 사진을 나타냅니다. 최대 800x800으로 구성됩니다. |
... ... ... description |
|
string |
|
아티스트 소개글이 나타냅니다. 최대 100글자로 구성됩니다. |
- (호출예)
http://www.maniadb.com/api/search.asp?key=example&target=music&v=0.3&itemtype=artist&option=artist&query=white
1. Request
요청 변수 | | 값 | | 설명 |
key | | string (필수) | | 이용 등록을 통해 받은 key 스트링을 입력합니다. |
a : 필수 | | interger | | maniadb album_id |
s | | integer | | maniadb album 중 상품 일련번호. 생략시 기본 앨범 정보 출력. |
2. Response (XML)
요청 변수 |
|
값 |
|
설명 |
rss |
|
- |
|
디버그를 쉽게 하고 RSS 리더기만으로 이용할 수 있게 하기 위해 만든 RSS 포맷의 컨테이너이며 그 외의 특별한 의미는 없습니다. |
... channel |
|
- |
|
앨범 정보를 포함하는 컨테이너입니다. 이 안에 있는 title, link 등의 항목은 참고용으로 무시해도 무방합니다. |
... ... lastBuildDate |
|
datetime |
|
앨범 정보를 최종 수정한 시간입니다. RFC1123 포멧으로 되어 있습니다. |
... ... item |
|
- |
|
앨범 정보를 보여주는 컨테이너로, 하나만 존재합니다. title, link을 포함합니다. 파라메터 id는 maniadb album_id를 의미합니다. |
... ... ... title |
|
string |
|
앨범 제목을 나타냅니다. |
... ... ... link |
|
string |
|
앨범 링크를 나타냅니다. |
... ... ... image |
|
string |
|
앨범 커버를 나타냅니다. 최대 800x800으로 구성됩니다. |
... ... ... description |
|
string |
|
앨범 소개글이 나타냅니다. 최대 100글자로 구성됩니다. |
... ... ... maniadb:merchants |
|
- |
|
앨범 가격 비교 대상 상점 목록입니다. |
... ... ... ... shop |
|
- |
|
상점에 대한 내부 관리 고유 이름입니다. |
... ... ... maniadb:artist |
|
- |
|
앨범의 대표 아티스트 정보를 나타냅니다. |
... ... ... ... id |
|
integer |
|
앨범의 아티스트ID를 나타냅니다. |
... ... ... ... name |
|
string |
|
앨범 아티스트의 이름을 나타냅니다. |
... ... ... maniadb:tracks |
|
- |
|
앨범의 수록곡 정보를 나타냅니다. |
... ... ... ... title |
|
string |
|
디스크별 제목을 나타냅니다. |
... ... ... ... song |
|
- |
|
TBD |
... ... ... maniadb:products |
|
- |
|
앨범 발매 상품의 정보를 나타냅니다. |
... ... ... ... product |
|
- |
|
TBD |
* Key발급 신청은 먼저 로그인을 하신 후, MyPage에서 해주시기 바랍니다.
* 기존에 ID없이 이용하시던 분들은 2008년 5월 31일까지 신청해주셔야 이상없이 사용하실 수 있습니다.
* 상업적인 목적으로 이용하실 경우는 아래 이메일( [email protected])로 문의 해주시기 바랍니다.
* 비상업적인 목적으로 이용하실 경우는 아래 CCL의 조건을 만족해주시면, 제약이 없습니다.
* maniadb는 크롤링과 노가다가 혼합해 구축된 것으로, 원 저작자의 요청에 의해 예고없이 특정 컨텐츠가 삭제될 수 있습니다.
|