Miss any of our Open RFC calls?Watch the recordings here! »

@flowereatfish/books-com-tw-api

1.0.5 • Public • Published

Unofficial Books-com-tw Collection API

NPM version Travis-CI status AppVeyor status Codecov status Dependencies status Code style License MIT

非官方博客來網路書店 API

Requirement

This construct uses Axios.js, so you need to care about Cross-Origin Requests (CORS).

Installation

npm install @flowereatfish/books-com-tw-api --save

Usage

Node.js version 8 or higher (with full Async/Await support)

const booksComTwCollectionApi = require('@flowereatfish/books-com-tw-api');
 
const run = async () => {
  const results = await booksComTwCollectionApi('橡皮擦計畫');
  console.log(results);
};
 
run();

Others

const booksComTwCollectionApi = require('@flowereatfish/books-com-tw-api');
 
booksComTwCollectionApi('橡皮擦計畫')
  .then(results => console.log(results));

Demo

Commands

# To download the files and install packages. 
$ git clone https://github.com/FlowerEatFish/books-com-tw-api.git
cd books-com-tw-api
$ npm install
 
# To run a demo. 
$ npm start

Results

>>> You search data using keyword "春夏秋冬,日日食光。生活美學家的鑄鐵鍋料理手帖".
 
[
  {
    title: '春夏秋冬,日日食光。生活美學家的鑄鐵鍋料理手帖',
    url: 'http://search.books.com.tw/redirect/move/key/%E6%98%A5%E5%A4%8F%E7%A7%8B%E5%86%AC%EF%BC%8C%E6%97%A5%E6%97%A5%E9%A3%9F%E5%85%89%E3%80%82%E7%94%9F%E6%B4%BB%E7%BE%8E%E5%AD%B8%E5%AE%B6%E7%9A%84%E9%91%84%E9%90%B5%E9%8D%8B%E6%96%99%E
7%90%86%E6%89%8B%E5%B8%96/area/mid/item/0010706739/page/1/idx/1/cat/001/pdf/1',
    author: [ '渡邊有子''游韻馨' ],
    publisher: '臉譜',
    publicationDate: '2016-02-27',
    imageUrl: 'https://www.books.com.tw/img/001/070/67/0010706739.jpg',
    price: { discount: 7, currentPrice: 252 },
    introduction: ', 在日本已分享了許多對於簡單生活的想法和實行秘訣, ' +
      '尤其在飲食方面,更提出許多同時注重美味、美感和健康的料理,因此廣受大眾歡迎。 在出版過許多料理食譜書後,她認為, ' +
      '使用春、夏、秋、冬的當令食材,搭配鑄鐵鍋,最能引出食材的天然風味......'
  }
]
>>> You search data using keyword "相對論,愛因斯坦教會我們什麼".
 
[ {...}, {...}, ... ] # Array.prototype.length <= 20 
>>> You search data using keyword "blablablablablablablablablablablabla".
 
null

API documentation

Input parameters

import booksComTwCollectionApi from '@flowereatfish/books-com-tw-api';
 
const result = booksComTwCollectionApi(
  keyword, // string. Necessary.
           // If you set it as null, it will get an error.
  page, // number. Positive integer. Default: 1.
        // Every page only shows maximum 20 results.
)

Output results

// If you get one or more result(s), it will return an "array".
result = [
  {
    title: string,
    author: string[] or null,
    publisher: string or null,
    publicationDate: string or null,
    imageUrl: string or null,
    introduction: string or null,
    price: {
      discount: number or null,
      currentPrice: number or null
    },
    url: string
  },
  { ... }, { ... }, ...
];
 
// If you have not got any result, it will return a "null".
result = null;

Install

npm i @flowereatfish/books-com-tw-api

DownloadsWeekly Downloads

1

Version

1.0.5

License

MIT

Unpacked Size

149 kB

Total Files

15

Last publish

Collaborators

  • avatar