doubanbookapi

README

doubanbookapi

Just as the name, the API implemention for "Douban Book".

You can query book information via api which provided by Douban.com and save it to local MongoDB.

Now a days, we finished the feature search engine supported via ElasticSearch.

Version

• 0.0.3

Content

• Requirements
• Installation
• Settings

Requirements

1. Internet connection
2. MongoDB v4.0.1 (Single-node or Cluster)
3. [Optional] ElasticSearch v6.4.2 (with IK plugin)

Installation

1. Make sure you have MongoDB installed and own the administrator role.
2. Create one database which named by "smartlibrarian".
3. Restore the Mongo(Structure & Data) by the json format script below.

   $PRJ_ROOT/install/mongodb/smartlibrarian.sl_book_new.json
   

4. Restore the ElasticSearch Index & Type mapping.

   $PRJ_ROOT/install/elasticsearch/sl_book_new.book.txt
   

Settings

Site Settings

Website listening on:

Addr: 0.0.0.0
Port: 8080

If you want to change, just modify the file below:

<PRJ_ROOT>/configs/AppConfig.go

DB Settings

You can change MongoDB service here:

<PRJ_ROOT>/configs/MongoDBConfig.go

ES Settings

You can change ElasticSearch service here:

<PRJ_ROOT>/configs/EsConfig.go

How to use

Query API

Query Mongo directly and no search engine accelerate.

You can query book by Isbn, Author and even by Douban book Identifier(id).

• by isbn

  • Method 1:

      curl -XGET http://localhost:8080/v1/book/isbn/{ISBN}
    

  • Or use the alias method, it's pretty shorter.

       curl -XGET http://localhost:8080/v1/book/{ISBN}    
    

• by author

    curl -XGET http://localhost:8080/v1/book/author/{AUTHOR}
  

• by douban idntifier

    curl -XGET http://localhost:8080/v1/book/id/{DOUBAN_ID}
  

Examples here:

• by isbn

    curl -XGET http://localhost:8080/v1/book/9787556820825
  

• by ahthor

    curl -XGET http://localhost:8080/v1/book/author/斯坦尼斯
  

• by douban id

    curl -XGET http://localhost:8080/v1/book/id/26952828
  

CIP API

Douban book API could not provide CIP information.

But we can fetch books' CIP information from opac.calis.edu.cn

P.S. Special Thanks to CALIS.

• Query by ISBN

  curl -XGET http://localhost:8080/v1/book/cip/{ISBN}

• Batch update local book CIPs

  Query local existed books which do not contain cip field and fetch CIP by ISBN.

  curl -XPOST http://localhost:8080/v1/book/cip

ISBN API

• Convert between ISBN13 and ISBN10

  curl -XGET http://localhost:8080/v1/isbn/convert/{ISBN}

  The parameter {ISBN} could be 10-bits or 13-bits.

Search API

Data accelerated by ElasticSearch.

• by KEYWORD

  • Basic query:

    curl -XGET http://localhost:8080/v1/search/?k={KEYWORD}

  • Paged query result:

    curl -XGET http://localhost:8080/v1/search/?k={KEYWORD}&pageNo=2&pageSize=10

  The records in result set would be splited into 10 per page.

  Current page is the #2nd page.