amsavarthan/goquotes-api

Quotes API written in golang

Go Quotes API

GO Quotes is a free, open source quotations API. It was built when I was getting started with GO lang. The sample database includes 500+ quotes. Live API Documentation

• Server
• API Methods
  • Get a random quote(s)
  • Get random quote(s) filtered by given type
  • Get all quotes
  • Get all authors
  • Get all tags
  • Get all data quotes by given type

Server

Note : The api will not work as it was hosted under free tier at Heroku & it has been exhausted due to high traffic. So clone and host your version of API and test them 🙂

Name	URL	Description
Production	https://goquotes-api.herokuapp.com/api/v1/	Synced with the master branch of this repo

API Methods

Get a random quote(s)

Returns number of random quotes

Path

GET /random

Query Parameters

Param	Type	Description
count	Int	Number of quotes to fetch

---

Get random quote(s) filtered by given type

Returns number of random quotes filtered by type

Path

GET /random/:count

Query Parameters

Param	Type	Description
count	Int	Number of quotes to fetch
type	String	Filter quotes by type (author/tag)
val	String	Filter quotes by value of type

---

Get all quotes

Returns every quotes available in the server

Path

GET /all/quotes

---

Get all authors

Returns every authors available in the server

Path

GET /all/authors

---

Get all tags

Returns every tags available in the server

Path

GET /all/tags

---

Get all data quotes by given type

Returns all quotes filtered by given type and value

Path

GET /all

Query Parameters

Param	Type	Description
type	String	Filter quotes by type (author/tag)
val	String	Filter quotes by value of type