Статьи

Документация и витрина API COLOURlovers

С выпуском API COLOURlovers теперь вы можете получить доступ к почти 1 миллиону именованных цветов и более 325 000 цветовых палитр для ваших творческих проектов и приложений. Создаете редактор тем и хотите предоставить своим пользователям несколько вариантов цветовой темы? Создание визуального проекта, который связывает ключевые слова с цветами? Кто знает, с какими удивительными вещами придут люди.

Ниже приведены два демонстрационных примера API COLOURlovers в действии, а также полная документация по API. Счастливого API COLOURloving!

COLOURlovers API Использование Витрина

Поиск цветов на рабочем столе — Приложение AIR

Desktop Color Search — это приложение Adobe AIR, которое запускается на вашем рабочем столе и позволяет вам искать во всей базе данных COLOURlovers цвета, палитры и узоры. Вам потребуется загрузить среду выполнения Adobe AIR, чтобы запустить Desktop Color Search. Чтобы установить AIR, воспользуйтесь приведенной ниже ссылкой. (Работает как в Windows, так и в Mac OS X). Отдельное спасибо Леви МакКаллуму из FutonMedia за кодирование приложения AIR.

Скачать Desktop Color Finder | Скачать Adobe AIR

desktopcolorfinder.jpg

DEKAF LOVERS

Простой интерфейс к библиотеке глубоких и глубоких палитр COLOURlover, он создает рандомизированные композиции с использованием прямоугольной геометрии, нарисованной библиотекой рисунков Degrafa. Получите удовольствие от своего собственного цветного веселья с любовниками Dekaf .

dekaflovers_api.jpg
dekaflovers_api_2.jpg
dekaflovers_api_3.jpg

Документация COLOURlovers API

Лицензия:


Attribution-Noncommercial-Share Alike —
http://creativecommons.org/licenses/by-nc-sa/3.0/

Если вы хотите использовать API за пределами данной лицензии, свяжитесь с нами для получения разрешения.

Цвета:


URL-адреса запроса: [для нескольких цветов]

Параметры [Case-sensitve]:
любовник, hueRange, briRange, ключевые слова, orderCol, sortBy, numResults,

примеры resultOffset :

lover = COLOURlover

hueRange = 12,68 [значения должны быть 0> значение <359, а левое значение должно быть меньше правого значения]

briRange = 2,88 [значения должны быть 0> значение <99, и левое значение должно быть меньше , чем правильное значение]

ключевых слов = поиск + термин

orderCol =
X[Где
Xможет быть:
dateCreated, оценка, имя, numVotes, numViews ]

SortBy =
X[Где
Xможет быть:
ASC, DESC ]

numResults = 20 [Количество возвращаемых результатов, максимум 100. По умолчанию 20]

resultOffset = 5 [Смещение результата, для подкачки. По умолчанию 0]

Запросы с orderColопределенным переопределят любой /newили /topпереключатся

URL запроса: [для одного цвета]

http://www.colourlovers.com/api/color/1133EF— Где
1133EFлюбое шестнадцатеричное шестнадцатеричное значение
Параметры:
N / A

Пример результата

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<colors>
<color>
<title><![CDATA[wet dirt]]></title>
<userName><![CDATA[jessicabrown]]></userName>
<numViews>0</numViews>
<numVotes>0</numVotes>
<numComments>0</numComments>
<numHearts>0</numHearts>
<rank>903853</rank>
<dateCreated>2008-03-17 11:22:21</dateCreated>
<hex>6B4106</hex>
<rgb>
<red>107</red>
<green>65</green>
<blue>6</blue>
</rgb>
<hsv>
<hue>35</hue>
<saturation>94</saturation>
<value>42</value>
</hsv>
<description><![CDATA[]]></description>
<url><![CDATA[http://www.colourlovers.com/color/6B4106/wet_dirt]]></url>
<imageUrl><![CDATA[http://www.colourlovers.com/img/6B4106/100/100/wet_dirt.png]]></imageUrl>
<apiUrl>http://www.colourlovers.com/api/color/6B4106</apiUrl>
</color>
</colors>

Разбивка API xml:

title Название / Название цвета CDATA
userName Имя пользователя создателя цвета CDATA
numViews Количество просмотров этого цвета
numVotes Количество голосов, полученных этим цветом
numComments Количество комментариев, полученных этим цветом
numHearts Количество сердец этого цвета
rank Ранг этого цвета на COLOURlovers.com
dateCreated Дата создания этого цвета
hex Шестнадцатеричное значение этого цвета
rgb RGB разбивка этого цвета
red Красное значение
green Зеленое значение
blue Синее значение
hsv HSV разбивка этого цвета
hue Значение оттенка
saturation Значение насыщенности
value Значение / Баланс
description Описание этого цвета CDATA
url URL этого цвета COLOURlovers.com CDATA
imageUrl Ссылка на png версию этого цвета CDATA
apiUrl URL этого цвета COLOURlovers.com API CDATA

Палитры:


URL-адреса запроса: [для нескольких палитр]

Параметры [Case-sensitve]:
любовник, hueOption, hex, ключевые слова, orderCol, sortBy, numResults, resultOffset

примеры:

любовник = COLOURlover

hueOption = желтый, оранжевый, красный [Возможные значения: красный, оранжевый, желтый, зеленый, аква, синий, фиолетовый, фуксия]

hueOption = желтый, оранжевый

hueOption = желтый

шестигранные = 00FF33

ключевые слова = поиск + термин

orderCol =
X[Где
Xможет быть:
dateCreated, score, name, numVotes, numViews ]

sortBy =
X[Где
Xможет быть:
ASC, DESC ]

numResults = 20 [Количество возвращаемых результатов, максимум 100. По умолчанию 20]

resultOffset= 5 [Смещение результата, для подкачки. По умолчанию 0]

Запросы с orderColопределенным переопределят любой /newили /topпереключатся

URL запроса: [для одной палитры]

http://www.colourlovers.com/api/palette/113451— Где
113451допустимый paletteID
Параметры:
N / A

Пример результата:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<palettes>
<palette>
<title><![CDATA[be my boy]]></title>
<userName><![CDATA[sinta schneider]]></userName>
<numViews>1052</numViews>
<numVotes>37</numVotes>
<numComments>13</numComments>
<numHearts>4.5</numHearts>
<rank>1</rank>
<dateCreated>2008-03-01 16:19:21</dateCreated>
<colors>
<hex>423238</hex>
<hex>F5DE8C</hex>
<hex>C8D197</hex>
<hex>B3702D</hex>
<hex>EB2138</hex>
</colors>
<description><![CDATA[]]></description>
<url><![CDATA[http://www.colourlovers.com/palette/293826/be_my_boy]]></url>
<imageUrl><![CDATA[http://www.colourlovers.com/paletteImg/423238/F5DE8C/C8D197/B3702D/EB2138/be_my_boy.png]></imageUrl>
<apiUrl>http://www.colourlovers.com/api/palette/293826</apiUrl>
</palette>
</palettes>

Разбивка API xml:

title Название / Название палитры CDATA
userName Имя пользователя создателя палитры CDATA
numViews Количество просмотров этой палитры
numVotes Количество голосов, полученных этой палитрой
numComments Количество комментариев, полученных этой палитрой
numHearts Номер палитры этого цвета
rank Ранг этой палитры на COLOURlovers.com
dateCreated Дата создания этой палитры
colors Список цветов в этой палитре
hex Шестнадцатеричное значение
hex Шестнадцатеричное значение
[hex] Шестнадцатеричное значение [может отсутствовать]
[hex] Шестнадцатеричное значение [может отсутствовать]
[hex] Шестнадцатеричное значение [может отсутствовать]
description Описание этой палитры CDATA
url URL этой палитры COLOURlovers.com CDATA
imageUrl Ссылка на png версию этой палитры CDATA
apiUrl URL этой палитры COLOURlovers.com API CDATA

Шаблоны:


URL-адреса запроса: [для нескольких шаблонов]

Параметры [Case-sensitve]:
любовник, hueOption, hex, ключевые слова, orderCol, sortBy, numResults, resultOffset

примеры:

любовник = COLOURlover

hueOption = желтый, оранжевый, красный [Возможные значения: красный, оранжевый, желтый, зеленый, аква, синий, фиолетовый, фуксия]

hueOption = желтый, оранжевый

hueOption = желтый

шестигранные = 00FF33

ключевые слова = поиск + термин

orderCol =
X[Где
Xможет быть:
dateCreated, score, name, numVotes, numViews ]

sortBy =
X[Где
Xможет быть:
ASC, DESC ]

numResults = 20 [Количество возвращаемых результатов, максимум 100. По умолчанию 20]

resultOffset= 5 [Смещение результата, для подкачки. По умолчанию 0]

Запросы с orderColопределенным переопределят любой /newили /topпереключатся

URL запроса: [для одного шаблона]

http://www.colourlovers.com/api/pattern/1451— Где
1451действительный patternID
Параметры:
N / A

Пример результата:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<patterns>
<pattern>
<title><![CDATA[Tenderness.]]></title>
<userName><![CDATA[not.an.am.person]]></userName>
<numViews>617</numViews>
<numVotes>32</numVotes>
<numComments>14</numComments>
<numHearts>4.5</numHearts>
<rank>1</rank>
<dateCreated>2008-03-01 06:43:38</dateCreated>
<colors>
<hex>C6C5AC</hex>
<hex>CDB89F</hex>
<hex>D4AA93</hex>
<hex>B8E0C5</hex>
<hex>BFD3B8</hex>
</colors>
<description><![CDATA[]]></description>
<url><![CDATA[http://www.colourlovers.com/pattern/49471/Tenderness.]]></url>
<imageUrl><![CDATA[http://colourlovers.com.s3.amazonaws.com/images/patterns/49/49471.png]></imageUrl>
<apiUrl>http://www.colourlovers.com/api/pattern/49471</apiUrl>
</pattern>
</patterns>

Разбивка API xml:

title Название / Название шаблона CDATA
userName Имя пользователя создателя шаблона CDATA
numViews Количество просмотров этой модели
numVotes Количество голосов, которое получила эта модель
numComments Количество комментариев, полученных этим шаблоном
numHearts Номер шаблона этого цвета
rank Ранг этой модели на COLOURlovers.com
dateCreated Дата создания этого шаблона
colors Список цветов в этом шаблоне
hex Шестнадцатеричное значение
hex Шестнадцатеричное значение
[hex] Шестнадцатеричное значение [может отсутствовать]
[hex] Шестнадцатеричное значение [может отсутствовать]
[hex] Шестнадцатеричное значение [может отсутствовать]
description Описание этой модели CDATA
url URL этого шаблона COLOURlovers.com CDATA
imageUrl Ссылка на png версию этого шаблона CDATA
apiUrl URL этого шаблона COLOURlovers.com API CDATA

Любители:


URL-адреса запроса: [для нескольких влюбленных]

Параметры [Case-sensitve]:
orderCol, sortBy, numResults, resultOffset,

примеры:

orderCol =
X[Где
Xможет быть:
lastActive, name ]

sortBy =
X[Где
Xможет быть:
ASC, DESC ]

numResults = 20 [Количество возвращаемых результатов, максимум 100. По умолчанию 20]

resultOffset = 5 [Смещение результата, для подкачки. По умолчанию 0]

Запросы с orderColопределенным переопределят любой /newили /topпереключатся

URL запроса: [для одного любовника]

http://www.colourlovers.com/api/lover/COLOURlover— Где
COLOURloverнаходится действующее имя пользователя COLOURlovers.com

[Case-sensitve]:
примеры комментариев

:

comments = 1 [покажет последние 10 комментариев для данного любовника]

Пример результата:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<lovers>
<lover>
<userName><![CDATA[electrikmonk]]></userName>
<dateRegistered>2005-08-07 6:45:47</dateRegistered>
<dateLastActive>2008-03-16 21:02:01</dateLastActive>
<rating>554159</rating>
<location><![CDATA[#FF0000stick, LA, US]]></location>
<numColors>3,498</numColors>
<numPalettes>2,775</numPalettes>
<numPatterns>36</numPatterns>
<numCommentsMade>7,201</numCommentsMade>
<numLovers>710</numLovers>
<numCommentsOnProfile>672</numCommentsOnProfile>
Optional comments [Only returned when viewing one lover with the ?comments=1]
<comments>
<comment>
<commentDate>2008-03-10 05:10:58</commentDate>
<commentUserName><![CDATA[mashedpotato]]></commentUserName>
<commentComments><![CDATA[you are so awesome. 😡 ]]></commentComments>
</comment>
</comments>
<url><![CDATA[http://www.colourlovers.com/lover/electrikmonk]]></url>
<apiUrl><![CDATA[http://www.colourlovers.com/api/lover/electrikmonk]]></apiUrl>
</lover>
</lovers>

Разбивка API xml:

userName Имя этого любовника CDATA
dateRegistered Дата, когда этот любовник зарегистрирован на COLOURlovers.com
dateLastActive Дата, когда этот любовник был последним активным на COLOURlovers.com
rating Рейтинг этого любовника
location Местоположение этого любовника
numColors Количество цветов, которые сделал этот любовник
numPalettes Количество палитр, которые сделал этот любовник
numPatterns Количество моделей, которые сделал этот любовник
numCommentsMade Количество комментариев, сделанных этим любовником
numLovers Количество влюбленных [друзей] у этого любовника
numCommentsOnProfile Количество комментариев, которые этот любовник имеет в своем профиле
Дополнительные комментарии [Возвращается только при просмотре одного любовника с помощью ?comments=1]
comments Последние 10 комментариев, сделанных на профиле этого любовника
comment Индивидуальный комментарий
commentDate Дата, когда был сделан комментарий Format YYYY-MM-DD HH:MM:SS - times are CST/CDT
commentUserName Имя пользователя Commenter’s COLOURlovers.com CDATA
commentComments И наконец, комментарии! CDATA
url URL этого любителя COLOURlovers.com CDATA
apiUrl URL этого любителя COLOURlovers.com API CDATA

Пример кода API [PHP]:

<?php
$curl = curl_init();
curl_setopt($curl,CURLOPT_URL,"http://www.colourlovers.com/api/colors/new");
curl_setopt($curl,CURLOPT_HEADER,false);
curl_setopt($curl,CURLOPT_RETURNTRANSFER,true);
$xml = curl_exec($curl);
curl_close($curl);

header("Content-Type: text/xml; charset=utf-8");
echo $xml;
?>

 

PHP Wrapper для API

phpColourLover PHP обертка для API COLOURlovers по
gsmonk