Skip to content

amsavarthan/goquotes-api

Repository files navigation

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

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

About

Quotes API written in golang

Topics

Resources

License

Stars

Watchers

Forks

Languages