{"id":48170550,"url":"https://github.com/jongwoo328/aladin-client","last_synced_at":"2026-04-04T17:33:41.012Z","repository":{"id":288894820,"uuid":"969481402","full_name":"jongwoo328/aladin-client","owner":"jongwoo328","description":"Unofficial JavaScript library for the Aladin API","archived":false,"fork":false,"pushed_at":"2025-07-24T02:40:53.000Z","size":70,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-04T07:50:45.025Z","etag":null,"topics":["aladin","api","client"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/aladin-client","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jongwoo328.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-04-20T08:44:28.000Z","updated_at":"2025-07-24T02:40:57.000Z","dependencies_parsed_at":"2025-04-20T15:53:19.929Z","dependency_job_id":null,"html_url":"https://github.com/jongwoo328/aladin-client","commit_stats":null,"previous_names":["jongwoo328/aladinjs","jongwoo328/aladin-client"],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/jongwoo328/aladin-client","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jongwoo328%2Faladin-client","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jongwoo328%2Faladin-client/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jongwoo328%2Faladin-client/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jongwoo328%2Faladin-client/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jongwoo328","download_url":"https://codeload.github.com/jongwoo328/aladin-client/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jongwoo328%2Faladin-client/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31407644,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-04T10:20:44.708Z","status":"ssl_error","status_checked_at":"2026-04-04T10:20:06.846Z","response_time":60,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aladin","api","client"],"created_at":"2026-04-04T17:33:40.419Z","updated_at":"2026-04-04T17:33:40.997Z","avatar_url":"https://github.com/jongwoo328.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# aladin-client\n\n[알라딘 온라인 서점 API](https://www.aladin.co.kr/ttb/apiguide.aspx)를 JavaScript로 쉽게 사용할 수 있게 해주는 비공식 라이브러리입니다.\n\n## 설치 방법\n### npm\n```bash\nnpm install aladin-client\n```\n### yarn\n```bash\nyarn add aladin-client\n```\n### pnpm\n```bash\npnpm add aladin-client\n```\n\n## 기능\n\u003e 제공하는 메서드들은 OPEN API의 각 요청과 1:1 대응됩니다.\n- 상품 검색 (ItemSearch.aspx)\n- 상품 리스트 조회 (ItemList.aspx)\n- 상품 조회 (ItemLookUp.aspx)\n- 중고상품 보유 매장 검색 (ItemOffStoreList.aspx)\n\n## 빠른 시작\n\n```javascript\nimport { Aladin } from 'aladin-client'\n\n// 클라이언트 초기화\nconst aladin = new Aladin({ttbKey: '\u003cYOUR TTB KEY\u003e'})\n\n// 상품 검색\nconst searchResult = await aladin.searchItems({query: 'Harry Potter'})\nif (searchResult.success) {\n  console.log(searchResult.data)\n} else {\n  console.error(searchResult.error.message)\n}\n\n// 상품 리스트 조회\nconst listResult = await aladin.listItems({queryType: 'ItemNewAll', categoryId: 57923 })\nif (listResult.success) {\n  console.log(listResult.data)\n} else {\n  console.error(listResult.error.message)\n}\n\n// 상품 조회\nconst itemResult = await aladin.lookupItem({itemId: 343667067, itemIdType: 'ItemId'})\nif (itemResult.success) {\n  console.log(itemResult.data)\n} else {\n  console.error(itemResult.error.message)\n}\n\n// 중고상품 보유 매장 검색\nconst offStoreResult = await aladin.listItemOffStore({itemId:343667067 , itemIdType: \"ItemId\"})\nif (offStoreResult.success) {\n  console.log(offStoreResult.data)\n} else {\n  console.error(offStoreResult.error.message)\n}\n```\n\n## API 문서\n- 공식 설명은 [API 페이지](https://www.aladin.co.kr/ttb/apiguide.aspx?Version=20131101) 및 [문서](https://docs.google.com/document/d/1mX-WxuoGs8Hy-QalhHcvuV17n50uGI2Sg_GHofgiePE)에서 확인 가능합니다.\n- 해당 라이브러리의 상세 API는 [API](docs/API.md) 페이지에서 확인 가능합니다.\n\n## 개발 환경 설정\n### 저장소 클론\n```bash\n# 저장소 클론\ngit clone https://github.com/username/aladin-client.git\ncd aladin-client\n```\n\n### 의존성 설치\n```bash\npnpm install\n```\n\n### 테스트 실행\n테스트 실행을 위해 `tests/` 디렉토리에 `key.json` 파일을 `key.template.json` 형식에 맞게 생성하세요.\n그 후,\n```bash\npnpm test\n```\n\n### 빌드\n```bash\npnpm build\n```\n\n### 코드 포맷\n```bash\npnpm format\n```\n\n## 기여 방법\n\u003e 🎉 누구나 기여를 환영합니다! 버그 수정, 기능 추가, 문서 개선 등 어떤 형태든 기여는 프로젝트의 발전에 큰 도움이 됩니다.\n1. 이 저장소를 포크합니다.\n2. 새 기능 브랜치를 생성합니다 (`git checkout -b feature/amazing-feature`)\n3. 변경 사항을 커밋합니다 (`git commit -m 'Add some amazing feature'`)\n4. 브랜치에 푸시합니다 (`git push origin feature/amazing-feature`)\n5. Pull Request를 생성합니다.\n\n## 라이선스\n\n이 프로젝트는 MIT 라이선스로 배포됩니다. 자세한 내용은 [LICENSE](LICENSE) 파일을 참고하세요.\n\n## 주의사항\n1. KEY 필요 \n    - 이 라이브러리를 사용하기 위해서는 알라딘 API 키가 필요합니다. API 키 발급 및 이용 약관은 [알라딘 API 페이지](https://www.aladin.co.kr/ttb/apiguide.aspx)를 참조하세요.\n    - API 사용 시 알라딘의 이용 약관을 준수해야 합니다.\n2. 비공식 라이브러리\n    - 이 라이브러리는 알라딘 공식 라이브러리가 아닙니다. 따라서 알라딘 API의 변경에 따라 작동하지 않을 수 있습니다.\n3. 타입스크립트 지원\n    - 이 라이브러리는 타입스크립트를 지원합니다. \n    - 공식 API 문서가 정확하지 않은 점, 그리고 별도 협의로 제공되는 결과값은 테스트할 수 없어 타입이 완벽하지 않을 수 있습니다.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjongwoo328%2Faladin-client","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjongwoo328%2Faladin-client","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjongwoo328%2Faladin-client/lists"}