oxypomme / mdi-api

API wrapper for MaterialDesignIcons

Home Page:https://mdi.oxypomme.fr/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

MDI API

Simple wrapper of Material Design Icons with a few more options.

The responses are based on the meta.json given by the @mdi/svg package. Current version is 7.1.96 (11/12/2022)

Data type

All API endpoints returns the following type :

interface APIResult {
 total?: number, // Total items in collection
 count: number, // Total items shown
 offset?: number, // Total items skiped,
 data: Icon|Icon[]
}

One icon is defined by the following type :

interface Icon {
 id: string,
 name: string,
 aliases: string[],
 data: string, // The SVG data
 user: {
  id: string,
  name: string,
 },
 commentCount: number
}

Query Options

  • limit: The number of item displayed (25 by default)
  • offset: The number of item to skip (0 by default)
  • select: Comma separated fields that you want in response (all by default)
  • search: Search for a specific word in icon's name or aliases
  • type: filled or outlined. Something else will send back both

Endpoints

  • /icons/: Get all the icons (returns Icon[]). Supported options :
    • limit
    • offset
    • select
    • search
    • type
  • /icons/:id: Get specific icon (returns Icon). Supported options :
    • select

About

API wrapper for MaterialDesignIcons

https://mdi.oxypomme.fr/

License:MIT License


Languages

Language:Vue 46.2%Language:JavaScript 46.0%Language:HTML 4.2%Language:Dockerfile 3.6%