API

palett.es dispone una pequeña API para que puedas integrar las funcionalidades básicas en cualquier aplicación.

V.1.0

[HEXCOLOR] hace referencia a un color en formato hexadecimal sin el hash (#) inicial. El color puede tener 3 o 6 caracteres.

El [MONOCHROMEINDEX] es un valor entre 0.0 y 1.0 (float) que indica lo diferentes entre si que son los colores que componen una paleta. Cuanto más cercano a 1.0 sea este valor más diferentes entre si serán y cuanto más cercano a 0.0 más similares (la paleta será más monocroma / uniforme).

Referencia

palett_es: '1.0'
info:
  title: palett.es API
  description: Get awesome colors with the palett.es API
  version: 1.0.0
host: palett.es
schemes:
  - http
basePath: /API/v1
produces:
  - application/json
paths:
  /palette:
    get|post:
      description: |
        Returns a random color palette
      parameters:
        - name: from
          in: query
          description: Base color used to generate palette
          required: false
          type: [HEXCOLOR]
          format: string
  /palette/monochrome:
    get|post:
      description: |
        Returns a random color palette below / over / between monochrome index
      parameters:
        - name: over
          in: query
          description: Monochrome index
          required: false
          type: [MONOCHROMEINDEX]
          format: float
        - name: below
          in: query
          description: Monochrome index
          required: false
          type: [MONOCHROMEINDEX]
          format: float
        - name: between
          in: query
          description: Monochrome index
          required: false
          type: [MONOCHROMEINDEX]
          format: float
response:
  '200':
    description: Array of 5 colors in hexadecimal format without the hash (#)
    schema:
      type: array

Peticiones de ejemplo a la API

A continución algunas peticiones de ejemplo de todos los métodos disponibles

// Random palette
http://palett.es/API/v1/palette

// Random color palette including #fabada color
http://palett.es/API/v1/palette/from/fabada

// Random palete with a monochrome index over 0.3
http://palett.es/API/v1/palette/monochrome/over/0.3

// Random palete with a monochrome index below 0.7
http://palett.es/API/v1/palette/monochrome/below/0.7

// Random palete with a monochrome index between 0.3 and 0.7
http://palett.es/API/v1/palette/monochrome/between/0.3/0.7

Disclaimer

La API de palett.es es un servicio gratuíto para proyectos personales, si planeas emplearlo en un proyecto comercial o con un gran volumen de peticiones por favor ponte en contacto conmigo en carloscabo [AT] gmail [DOT] com.

Ejemplos