farzi-vichar-api

Farzi Vichar API

• Hi! My name is Akkshay Tandon. Apart from development, there is another side of mine. I started writing some shayari out of interest in my second year of college and without even realizing I wrote many of them, although not all of them are added in the API still. I even started a instagram page by the name Farzi Vichar.

• But there was something missing, and then a random thought came to my mind of combining both my technical and writing skills.There came the idea of this API.

• I have decided to make this project open source, so if you are getting started with open source or you just want to add more data, consider this repository to contribute. You will find more details related to contributing here.

Implementations

• This is the current list of implementations:

  • Random Hindi Shayari Website
  • Random Shayari Generator Extension

Usage

• The method(s) you can use are, only GET and POST.
• The API is structured in a way that you will need to provide a language to the route, otherwise you will receive an error.
• The route is such : https://farzi-vichar-api.vercel.app/language/${language_name}.
• Example: access hindi data. Similarily you can access data for other languages also.

• For getting the list of languages, use:

  https://farzi-vichar-api.vercel.app/language-list
  

• For adding user submitted quotes, use:

  const options = {
     method: 'POST',
     headers: {
       'Content-Type': 'application/json',
     },
     body: JSON.stringify({
       "author": "Test Author",
       "content": "Test Author content"
     })
  };
  fetch('https://farzi-vichar-api.vercel.app/add-user-quote', options).then(response => response.json()).then(data => console.log(data)).catch((error) => {
     console.log(error);
   });
  

Structure

• There are mainly three ways to access a language data:
  • either full data of the language provided
  • or a range of data from the language provided
  • or a random data from the language provided
• For accessing full data, use the route as : https://farzi-vichar-api.vercel.app/language/${language_name}
• For accessing data in a range, use the route as : https://farzi-vichar-api.vercel.app/language/${language_name}?min=${min_value}&max=${max_value}
• For accessing a random data, use the route as : https://farzi-vichar-api.vercel.app/language/${language_name}/random

Contributing to the project

• Read CONTRIBUTING.md for guidelines.

TO_DO

• Add a database to the API to read and write user submitted quotes
• May add SQLite database for read-only, already available data
• Handle errors with better response
• Add data in existing language(s)
• Add data for more languages

This site is open source. Improve this page.