Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.pixcraft.es/llms.txt

Use this file to discover all available pages before exploring further.

​
Get Colors

GET /api/v1/colors/{niche}
Returns the color catalog for a specific niche. If your API key has custom colors configured, those will be returned instead of the default catalog.

​
Path parameters

​
niche
string
required
Niche ID (e.g., curtains, mosaics, lego)

​
Example request

curl https://www.pixcraft.es/api/v1/colors/curtains \
  -H "Authorization: Bearer px_live_your_key"

​
Example response

{
  "niche": "curtains",
  "catalog": "default",
  "colors": [
    {
      "id": "blanco",
      "name": "Blanco",
      "hex": "#FFFFFF",
      "available": true
    },
    {
      "id": "crema",
      "name": "Crema",
      "hex": "#FFFDD0",
      "available": true
    },
    {
      "id": "negro",
      "name": "Negro",
      "hex": "#000000",
      "available": true
    }
  ]
}

​
Custom color catalogs

If your API key has custom_colors configured, the catalog field will be "custom" and the colors array will contain your custom palette instead of the default one. Configure custom colors in your API Keys dashboard.

​
Common errors

CodeDescription
INVALID_NICHEThe niche ID does not exist or is not on your plan