Lolis-rest - RESTful API for lolis-api

Overview

Lolis REST

RESTful + Website for Lolis API.

Introduction

This is a RESTful API which will be used on Lolis API Website and Wrapper. This API uses Imgur to get images from different existing album for different endpoints.

Terms of use

Please note that this API is free for non-commercial usage, that's mean you cannot make money with it, otherwise, you are free to use it.

API Version

Current API version: v1
Base URL: https://api.waifu.sbs
Supported request: GET

Bug report

Found a bug? Contact me - Email - Discord: LT#0100

Authorization

This API does not require any types of authorization. Just make a GET request and you are done.

Endpoints

/loli

Overview

Retrieve an image link (imgur) about loli.

URL

https://api.waifu.sbs/loli

Parameters

  • format [gif, pic] - Get format of image (Gif image or PNG/JPG image).
  • nsfw [boolean] - NSFW image.

Response

{
    success: true,
    code: 200,
    data: {
        type: "loli",
        url: "https://i.imgur.com/example.png",
        width: 1280,
        height: 720,
        size: 69420727,
        nsfw: false,
        isGif: false
    }
}

/shota

Overview

Retrieve an image link (imgur) about shota.

URL

https://api.waifu.sbs/shota

Parameters

  • format [gif, pic] - Get format of image (Gif image or PNG/JPG image).
  • nsfw [boolean] - NSFW image.

Response

{
    success: true,
    code: 200,
    data: {
        type: "shota",
        url: "https://i.imgur.com/example.png",
        width: 1280,
        height: 720,
        size: 69420727,
        nsfw: false,
        isGif: false
    }
}

/random

Overview

Retrieve a random image link (imgur).

URL

https://api.waifu.sbs/random

Parameters

  • type [loli, shota] - Get type of image (loli or shota).
  • format [gif, pic] - Get format of image (Gif image or PNG/JPG image).
  • nsfw [boolean] - NSFW image.

Response

{
    success: true,
    code: 200,
    data: {
        type: "loli",
        url: "https://i.imgur.com/example.png",
        width: 1280,
        height: 720,
        size: 69420727,
        nsfw: false,
        isGif: false
    }
}

Status codes

Code Description Occur reason
200 Successful Successful request.
204 No content The album on imgur of specified endpoint does not contain any images.
403 Permission denied Imgur Client-ID header maybe invalid or empty.
404 Not found Cannot GET /
500 Internal Error Something went wrong with the API (Album ID is empty, function exceptions).

Error response

{
    success: false,
    code: 403,
    error: "Permission denied"
}

Examples

Curl

curl https://api.waifu.sbs/loli

Node.js

const axios = require("axios");

async function getImage() {
    try {
        var response = await axios.get('https://api.waifu.sbs/loli');
        console.log(response);
    } catch (err) {
        console.log(err);
    }
}

getImage();

jQuery

<p id="data"></p>
$.getJSON("https://api.waifu.sbs/loli", function(res) { 
    $("#data").text = res.data.link;
});

Python

import requests

data = requests.get('https://api.waifu.sbs/loli')
print(data.data.link)

Contribute

You can contribute to this project by submitting images about loli/shota.

or

  1. Fork and clone the repository
git clone https://github.com/username/lolis-rest.git
  1. Commit your changes
git add .
git commit -m "cool new feature"
  1. Push your changes
git push
  1. Submit a pull request

Credit

  • Lolis.life for inspiring this project.
You might also like...

A RESTful API for Bing wallpaper to use easy.

A RESTful API for Bing wallpaper to use easy.

bing-wallpaper A RESTful API for Bing wallpaper to use easy. img src="https://bingw.jasonzeng.dev/?w=800"/ Usage API Endpoint: https://bingw.jasonze

Dec 15, 2022

A RESTful API to support online store.

A RESTful API to support online store.

📝 Table of Contents About API Endpoint Get started Installation Running Building for production Running Tests Technology Contributors License 📙 Abou

Dec 17, 2022

A focused RESTful server framework for Deno 🌰🦕

acorn Rapidly develop and iterate on RESTful APIs using a strongly typed router designed for Deno CLI and Deno Deploy. import { Router } from "https:/

Dec 10, 2022

Front-End for the RESTful implementation of Texta Toolkit

TEXTA This project was generated with Angular CLI version 7.3.8. Configuration Configuration properties Name Description apiHost texta-rest API Host (

Dec 16, 2022

A boilerplate for ExpressJs projects configured with ESLint, Prettier & Airbnb Setup. The boilerplate utilises RESTful architecture and uses Mongodb.

A boilerplate for ExpressJs projects configured with ESLint, Prettier & Airbnb Setup. The boilerplate utilises RESTful architecture and uses Mongodb.

ExpressJs-Boilerplate An ExpressJs boilerplate configured with ESLint, Prettier & Airbnb Setup. The boilerplate utilises RESTful architecture and uses

Mar 8, 2023

Webb-tracker-api - James Webb Space Telescope (JWST) tracking REST API

Webb-tracker-api - James Webb Space Telescope (JWST) tracking REST API

James Webb Telescope tracking REST API Public REST API to track JWST's current status API data source: https://www.jwst.nasa.gov/content/webbLaunch/wh

Nov 22, 2022

A base API template for a REST API using express.

A base API template for a REST API using express.

express-api-template A base API template for a REST API using express. Philosophy Setting up a new project can be a long and tedious process, especial

May 29, 2022

An Amazon Kendra REST API CDK example with an API Gateway, including authentication with AWS Cognito and AWS X-Ray Tracing

An Amazon Kendra REST API CDK example with an API Gateway, including authentication with AWS Cognito and AWS X-Ray Tracing

Amazon Kendra Web Service CDK Sample Amazon Kendra has a robust JSON API for use with the AWS SDK (software development kit), but does not expose endp

Nov 28, 2022

Rest API untuk mengumpulkan jokes receh dan meme dari Indonesia

Candaan API 😁 Candaan API merupakan Rest API yang dibuat untuk mendapatkan beberapa jokes jokes receh dari Indonesia, semua data data yang ada di Can

Jan 3, 2023
Owner
Waifu.sbs
Waifu.sbs
Hemsida för personer i Sverige som kan och vill erbjuda boende till människor på flykt

Getting Started with Create React App This project was bootstrapped with Create React App. Available Scripts In the project directory, you can run: np

null 4 May 3, 2022
Kurs-repo för kursen Webbserver och Databaser

Webbserver och databaser This repository is meant for CME students to access exercises and codealongs that happen throughout the course. I hope you wi

null 14 Jan 3, 2023
This is a vanilla Node.js rest API created to show that it is possible to create a rest API using only vanilla Node.js

This is a vanilla Node.js rest API created to show that it is possible to create a rest API using only vanilla Node.js. But in most cases, I would recommend you to use something like Express in a production project for productivity purposes.

Eduardo Dantas 7 Jul 19, 2022
RESTful API using Hapi NodeJs Framework. This app is project from Dicoding Couses, Belajar Membuat Aplikasi Back-end untuk Pemula

RESTful API using Hapi NodeJs Framework. This app is project from Dicoding Couses, Belajar Membuat Aplikasi Back-end untuk Pemula

Muhammad Ferdian Iqbal 1 Jan 3, 2022
MiniSense RESTful API

MiniSense RESTful API Why was it developed This project is part of an activity proposed by SenseUp aimed at approving a selection process for a Back-E

Alef Sena 1 Jan 21, 2022
RESTful service to provide API linting as-a-service

API Linting Service Prerequisites / general idea General idea behind this API implementation is to provide an API as a service based on the awesome sp

Schwarz IT 6 Mar 14, 2022
🎵 simple and RESTful API for getting lyrics of any song made using Next.js and ChakraUI.

playground . guide . discord Overview Lyrist is a simple yet powerful RESTful API for getting lyrics of any song using song name and it's artist name.

ashish 21 Dec 17, 2022
A dockerized uptime monitoring RESTful API server that allows authenticated users to monitor URLs

A dockerized uptime monitoring RESTful API server that allows authenticated users to monitor URLs, and get detailed uptime reports about their availability, average response time, and total uptime/downtime.

Anas Hamed 2 Oct 7, 2022
Here's a RESTful API that interacts with a PostgreSQL database written in NodeJS with Typescript, RESTify, and Sequelize ORM.

Basic description REST (Representational State Transfer) is a standard architecture for building and communicating with web services, It typically man

Olabisi Oduola 2 Jan 14, 2022
Uptime monitoring RESTful API server that allows authenticated users to monitor URLs, and get detailed uptime reports about their availability, average response time, and total uptime/downtime.

Uptime Monitoring API Uptime monitoring RESTful API server that allows authenticated users to monitor URLs, and get detailed uptime reports about thei

Mohamed Magdi 2 Jun 14, 2022