m3o-go/examples/sunnah/README.md

Sunnah

An m3o.com API. For example usage see m3o.com/sunnah/api.

Endpoints:

Collections

Get a list of available collections. A collection is a compilation of hadiths collected and written by an author.

https://m3o.com/sunnah/api#Collections

package example

import(
	"fmt"
	"os"

	"go.m3o.com/sunnah"
)

// Get a list of available collections. A collection is
// a compilation of hadiths collected and written by an author.
func ListAvailableCollections() {
	sunnahService := sunnah.NewSunnahService(os.Getenv("M3O_API_TOKEN"))
	rsp, err := sunnahService.Collections(&sunnah.CollectionsRequest{
		
	})
	fmt.Println(rsp, err)
	
}

Books

Get a list of books from within a collection. A book can contain many chapters each with its own hadiths.

https://m3o.com/sunnah/api#Books

package example

import(
	"fmt"
	"os"

	"go.m3o.com/sunnah"
)

// Get a list of books from within a collection. A book can contain many chapters
// each with its own hadiths.
func GetTheBooksWithinAcollection() {
	sunnahService := sunnah.NewSunnahService(os.Getenv("M3O_API_TOKEN"))
	rsp, err := sunnahService.Books(&sunnah.BooksRequest{
		Collection: "bukhari",

	})
	fmt.Println(rsp, err)
	
}

Chapters

Get all the chapters of a given book within a collection.

https://m3o.com/sunnah/api#Chapters

package example

import(
	"fmt"
	"os"

	"go.m3o.com/sunnah"
)

// Get all the chapters of a given book within a collection.
func ListTheChaptersInAbook() {
	sunnahService := sunnah.NewSunnahService(os.Getenv("M3O_API_TOKEN"))
	rsp, err := sunnahService.Chapters(&sunnah.ChaptersRequest{
		Book: 1,
Collection: "bukhari",

	})
	fmt.Println(rsp, err)
	
}

Hadiths

Hadiths returns a list of hadiths and their corresponding text for a given book within a collection.

https://m3o.com/sunnah/api#Hadiths

package example

import(
	"fmt"
	"os"

	"go.m3o.com/sunnah"
)

// Hadiths returns a list of hadiths and their corresponding text for a
// given book within a collection.
func ListTheHadithsInAbook() {
	sunnahService := sunnah.NewSunnahService(os.Getenv("M3O_API_TOKEN"))
	rsp, err := sunnahService.Hadiths(&sunnah.HadithsRequest{
		Book: 1,
Collection: "bukhari",

	})
	fmt.Println(rsp, err)
	
}