book18api

Book18 API Documentation

This documentation provides an overview of the book18api package, which is a Go library for interacting with the Book18 website (https://www.book18.org). The library allows you to retrieve book chapters, book indexes, search for books, and more.

Installation

To use the book18api package in your Go project, you need to install it using the following command:

go get github.com/hhhBooksLib/book18api

Usage

Import the book18api package in your Go code:

import "github.com/hhhBooksLib/book18api"

ClientBook18 Interface

The ClientBook18 interface defines the methods for interacting with the Book18 API:

type ClientBook18 interface {
	GetChapterByChapterId(chapterId string) *Chapter
	GetBookIndexByPage(page int) []IndexBook
	SearchBookInfoByKeyword(keyword string, page int) []SearchBook
	LongBookChapterIndex(bookName string) []BookCatalog
}

ClientApi

The ClientApi struct implements the ClientBook18 interface and provides methods for accessing the Book18 API:

type ClientApi struct {
Get func (url string, params any) *goquery.Document
}

NewBook18Client

The NewBook18Client function creates a new instance of the ClientApi struct:

func NewBook18Client() ClientBook18 {
	return &ClientApi{
	Get: func (url string, params any) *goquery.Document {
		return client.NewClient(20).UrlSite("https://www.book18.org").UrlPoint(url).GetMethod().Query(params).
	NewRequest().Document()},
}
}

GetChapterByChapterId

The GetChapterByChapterId method retrieves a specific chapter by its ID:

func (book *ClientApi) GetChapterByChapterId(chapterId string) *Chapter {
// Implementation details...
}

GetBookIndexByPage

The GetBookIndexByPage method retrieves the book index for a specific page:

func (book *ClientApi) GetBookIndexByPage(page int) []IndexBook {
// Implementation details...
}

SearchBookInfoByKeyword

The SearchBookInfoByKeyword method searches for books based on a keyword and page number:

func (book *ClientApi) SearchBookInfoByKeyword(keyword string, page int) []SearchBook {
// Implementation details...
}

LongBookChapterIndex

The LongBookChapterIndex method retrieves the chapter index for a long book:

func (book *ClientApi) LongBookChapterIndex(bookName string) []BookCatalog {
// Implementation details...
}

ClientShortApi

The ClientShortApi struct implements the ClientBook18 interface for short articles:

type ClientShortApi struct {
Get func (url string, params any) *goquery.Document
}

NewBook18ShortClient

The NewBook18ShortClient function creates a new instance of the ClientShortApi struct:

func NewBook18ShortClient() ClientBook18 {
    return &ClientShortApi{
        Get: func (url string, params any) *goquery.Document {
            return client.NewClient(20).UrlSite("https://www.book18.org").UrlPoint(url).GetMethod().Query(params).
                NewRequest().Document()
	},
    }
}

GetChapterByChapterId

The GetChapterByChapterId method retrieves a specific chapter for a short article by its ID:

func (book *ClientShortApi) GetChapterByChapterId(chapterId string) *Chapter {
// Implementation details...
}

DownloadLongBookChapters

The DownloadLongBookChapters function downloads all chapters of a long book concurrently:

func DownloadLongBookChapters(bookName string) chan *Chapter {
// Implementation details...
}