С выпуском 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
DEKAF LOVERS
Простой интерфейс к библиотеке глубоких и глубоких палитр COLOURlover, он создает рандомизированные композиции с использованием прямоугольной геометрии, нарисованной библиотекой рисунков Degrafa. Получите удовольствие от своего собственного цветного веселья с любовниками Dekaf .
Документация COLOURlovers API
Лицензия:
Attribution-Noncommercial-Share Alike —
http://creativecommons.org/licenses/by-nc-sa/3.0/
Если вы хотите использовать API за пределами данной лицензии, свяжитесь с нами для получения разрешения.
Цвета:
URL-адреса запроса: [для нескольких цветов]
любовник, hueRange, briRange, ключевые слова, orderCol, sortBy, numResults,
примеры resultOffset :
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-адреса запроса: [для нескольких палитр]
любовник, hueOption, hex, ключевые слова, orderCol, sortBy, numResults, resultOffset
примеры:
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 запроса: [для одной палитры]
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-адреса запроса: [для нескольких шаблонов]
любовник, hueOption, hex, ключевые слова, orderCol, sortBy, numResults, resultOffset
примеры:
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 запроса: [для одного шаблона]
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-адреса запроса: [для нескольких влюбленных]
orderCol, sortBy, numResults, resultOffset,
примеры:
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]:
примеры комментариев
:
Пример результата:
<?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