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