ColourLovers图案调色板API

接入教程

1. 访问ColourLovers官网注册获取API密钥
2. 查阅API文档了解可用端点（图案/调色板/图像）
3. 调用patterns/palettes端点获取资源列表
4. 使用参数进行关键词、颜色等筛选
5. 解析JSON响应数据并集成到应用中
6. 可下载PNG格式图像或色彩数值

使用Python获取流行调色板

python

import requests

url = 'https://www.colourlovers.com/api/palettes/top'
params = {
    'format': 'json',
    'numResults': 5
}
headers = {
    'Authorization': 'Bearer YOUR_API_KEY'
}

response = requests.get(url, params=params, headers=headers)
if response.status_code == 200:
    palettes = response.json()
    for palette in palettes:
        print(palette['title'], palette['colors'])
else:
    print('Request failed:', response.status_code)

使用PHP检索图案列表

php

<?php

$url = 'https://www.colourlovers.com/api/patterns';
$queryParams = [
    'format' => 'json',
    'keywords' => 'nature',
    'numResults' => 3
];
$fullUrl = $url . '?' . http_build_query($queryParams);

$options = [
    'http' => [
        'header' => "Authorization: Bearer YOUR_API_KEY\r\n"
    ]
];
$context = stream_context_create($options);
$response = file_get_contents($fullUrl, false, $context);

if ($response !== false) {
    $patterns = json_decode($response, true);
    foreach ($patterns as $pattern) {
        echo $pattern['title'] . '\n';
    }
} else {
    echo 'Request failed';
}

?>

使用JavaScript获取随机颜色

javascript

const url = 'https://www.colourlovers.com/api/colors/random';
const params = new URLSearchParams({
    format: 'json',
    numResults: -1
});

fetch(`${url}?${params}`, {
    headers: {
        'Authorization': 'Bearer YOUR_API_KEY'
    }
})
.then(response => {
    if (!response.ok) {
        throw new Error(`HTTP error! status: ${response.status}`);
    }
    return response.json();
})
.then(colors => {
    colors.forEach(color => {
        console.log(color.title, color.hex);
    });
})
.catch(error => {
    console.error('Request failed:', error);
});

常见问题

如何获取API密钥？

访问ColourLovers官网注册账户，在开发者控制台申请API密钥。免费版本有调用频率限制，如需更高配额需升级账户。

API支持哪些数据格式？

ColourLovers API支持JSON和XML两种响应格式，可通过format参数指定，默认为JSON格式。

调用API时有频率限制吗？

是的，免费API密钥每分钟限制10次请求。建议合理缓存数据，避免频繁调用，必要时可联系官方调整限制。