Cepas

Las cepas (strains) representan las variedades genéticas de cannabis disponibles en el sistema. Esta API permite consultar el catálogo de cepas con filtros avanzados por tipo, cannabinoides, terpenos y efectos terapéuticos.

La API de Cepas es un endpoint BFF (Backend for Frontend) que agrega datos de múltiples fuentes y proporciona una interfaz simplificada para el frontend.

El modelo de Cepa

El modelo de cepa contiene información genética, química y terapéutica detallada.

Propiedades

Name
id
Type
string
Description
Identificador único de la cepa.
Name
name
Type
string
Description
Nombre principal de la cepa.
Name
altNames
Type
string
Description
Nombres alternativos separados por coma.
Name
type
Type
enum
Description
Tipo genético: sativa, indica o hybrid.
Name
description
Type
string
Description
Descripción detallada de la cepa.
Name
cannabinoids
Type
object
Description
Contenido de cannabinoides.
Name
thc
Type
number
Description
Porcentaje de THC (0-35).
Name
cbd
Type
number
Description
Porcentaje de CBD (0-20).
Name
cbg
Type
number
Description
Porcentaje de CBG.
Name
cbn
Type
number
Description
Porcentaje de CBN.
Name
terpenes
Type
array
Description
Lista de terpenos predominantes.
Name
effects
Type
object
Description
Efectos reportados.
Name
helpsWith
Type
array
Description
Condiciones que ayuda a tratar.
Name
feelings
Type
array
Description
Sensaciones que produce.
Name
negatives
Type
array
Description
Posibles efectos negativos.
Name
flavors
Type
array
Description
Sabores y aromas.
Name
genetics
Type
object
Description
Información genética.
Name
parents
Type
array
Description
Cepas padre.
Name
children
Type
array
Description
Cepas derivadas.
Name
breeder
Type
string
Description
Criador/banco de semillas.
Name
growInfo
Type
object
Description
Información de cultivo.

Ejemplo de cepa completa

{
  "id": "strain_blue_dream",
  "name": "Blue Dream",
  "altNames": "Azure Haze, BD",
  "type": "hybrid",
  "description": "Blue Dream es una cepa híbrida sativa-dominante que cruza Blueberry con Haze. Conocida por su equilibrio entre relajación cerebral y estimulación corporal.",
  "cannabinoids": {
    "thc": 21,
    "cbd": 0.1,
    "cbg": 1
  },
  "terpenes": [
    "Mirceno",
    "Pineno",
    "Cariofileno",
    "Limoneno"
  ],
  "effects": {
    "helpsWith": [
      "Dolor",
      "Depresión",
      "Náuseas",
      "Estrés",
      "Ansiedad"
    ],
    "feelings": [
      "Eufórico",
      "Creativo",
      "Relajado",
      "Feliz",
      "Energético"
    ],
    "negatives": [
      "Boca seca",
      "Ojos rojos",
      "Ansiedad (raro)"
    ]
  },
  "flavors": [
    "Arándano",
    "Dulce",
    "Terroso",
    "Frutal"
  ],
  "genetics": {
    "parents": ["Blueberry", "Haze"],
    "children": ["Blue Dream CBD"],
    "breeder": "DJ Short"
  },
  "growInfo": {
    "difficulty": "moderate",
    "floweringTime": { "min": 9, "max": 10 },
    "yield": {
      "indoor": "500-600g/m²",
      "outdoor": "600-700g/planta"
    },
    "height": "tall",
    "type": "both"
  }
}

Tipos de Cepa

Clasificación Genética

Tipo	Características	Efectos Típicos
Sativa	Alta, hojas delgadas, floración larga	Energizante, cerebral, creativo
Indica	Compacta, hojas anchas, floración corta	Relajante, corporal, sedante
Hybrid	Combinación de características	Balance de efectos sativa/indica

Proporción en Híbridos

// Clasificación por dominancia
type HybridType =
  | 'sativa-dominant'  // >60% sativa
  | 'balanced'         // 40-60%
  | 'indica-dominant'  // >60% indica

GET/api/strains

Listar cepas

Este endpoint permite obtener una lista filtrada de cepas del catálogo.

Parámetros de Consulta

Name
type
Type
string
Description
Filtrar por tipo: sativa, indica, hybrid.
Name
thcMin
Type
number
Description
THC mínimo (0-35).
Name
thcMax
Type
number
Description
THC máximo (0-35).
Name
cbdMin
Type
number
Description
CBD mínimo (0-20).
Name
cbdMax
Type
number
Description
CBD máximo (0-20).
Name
terpenes
Type
string
Description
Terpenos separados por coma.
Name
effects
Type
string
Description
Efectos deseados separados por coma.
Name
helpsWith
Type
string
Description
Condiciones a tratar separadas por coma.
Name
search
Type
string
Description
Búsqueda por nombre.
Name
limit
Type
number
Description
Límite de resultados (default: 20).
Name
offset
Type
number
Description
Offset para paginación.

Request

GET

/api/strains

curl -G https://api.cannahub.tech/api/strains \
  -H "Authorization: Bearer {token}" \
  -d type=hybrid \
  -d thcMin=15 \
  -d thcMax=25 \
  -d effects=relaxed,creative

Response

{
  "strains": [
    {
      "id": "strain_blue_dream",
      "name": "Blue Dream",
      "type": "hybrid",
      "cannabinoids": {
        "thc": 21,
        "cbd": 0.1
      },
      "terpenes": ["Mirceno", "Pineno"],
      "effects": {
        "feelings": ["Relajado", "Creativo"]
      }
    },
    {
      "id": "strain_gelato",
      "name": "Gelato",
      "type": "hybrid",
      "cannabinoids": {
        "thc": 20,
        "cbd": 0.1
      },
      "terpenes": ["Limoneno", "Cariofileno"],
      "effects": {
        "feelings": ["Relajado", "Eufórico"]
      }
    }
  ],
  "count": 15,
  "limit": 20,
  "offset": 0
}

GET/api/strains/:id

Obtener cepa

Este endpoint retorna los detalles completos de una cepa específica.

Request

GET

/api/strains/:id

curl https://api.cannahub.tech/api/strains/strain_blue_dream \
  -H "Authorization: Bearer {token}"

Response

{
  "strain": {
    "id": "strain_blue_dream",
    "name": "Blue Dream",
    "type": "hybrid",
    "description": "Blue Dream es una cepa...",
    "cannabinoids": { ... },
    "terpenes": [ ... ],
    "effects": { ... },
    "flavors": [ ... ],
    "genetics": { ... },
    "growInfo": { ... }
  }
}

Filtros Avanzados

Por Terpenos

Los terpenos determinan el aroma y contribuyen a los efectos de la cepa.

Name
Mirceno
Type
terpene
Description
Aroma terroso, efectos sedantes.
Name
Limoneno
Type
terpene
Description
Aroma cítrico, eleva el ánimo.
Name
Cariofileno
Type
terpene
Description
Aroma especiado, antiinflamatorio.
Name
Pineno
Type
terpene
Description
Aroma a pino, mejora enfoque.
Name
Linalool
Type
terpene
Description
Aroma floral, relajante.
Name
Humuleno
Type
terpene
Description
Aroma terroso, supresor de apetito.

Filtrar por terpenos

curl -G https://api.cannahub.tech/api/strains \
  -d "terpenes=limoneno,pineno"

Response

{
  "strains": [
    {
      "name": "Super Lemon Haze",
      "terpenes": ["Limoneno", "Pineno", "Cariofileno"]
    },
    {
      "name": "Jack Herer",
      "terpenes": ["Pineno", "Limoneno", "Mirceno"]
    }
  ]
}

Por Efectos Terapéuticos

Name
dolor
Type
helpsWith
Description
Alivio del dolor crónico y agudo.
Name
ansiedad
Type
helpsWith
Description
Reducción de síntomas de ansiedad.
Name
depresion
Type
helpsWith
Description
Mejora del estado de ánimo.
Name
insomnio
Type
helpsWith
Description
Ayuda para conciliar el sueño.
Name
nauseas
Type
helpsWith
Description
Alivio de náuseas y vómitos.
Name
inflamacion
Type
helpsWith
Description
Reducción de inflamación.

Filtrar por condición

curl -G https://api.cannahub.tech/api/strains \
  -d "helpsWith=dolor,insomnio" \
  -d "type=indica"

Response

{
  "strains": [
    {
      "name": "Granddaddy Purple",
      "type": "indica",
      "effects": {
        "helpsWith": ["Dolor", "Insomnio", "Estrés"]
      }
    },
    {
      "name": "Purple Kush",
      "type": "indica",
      "effects": {
        "helpsWith": ["Dolor", "Insomnio", "Ansiedad"]
      }
    }
  ]
}

Productos con Cepa

Las cepas se asocian a productos de flor a través del metadata.

Obtener productos por cepa

curl -G https://api.cannahub.tech/api/products \
  -d "strainId=strain_blue_dream"

Estructura en producto

El producto incluye la información de cepa completa cuando isFlower: true.

Producto con cepa

{
  "id": "prod_01HQ8BLUE_DREAM",
  "name": "Blue Dream Indoor",
  "isFlower": true,
  "strain": {
    "id": "strain_blue_dream",
    "name": "Blue Dream",
    "type": "hybrid",
    "cannabinoids": {
      "thc": 21,
      "cbd": 0.1
    },
    "terpenes": ["Mirceno", "Pineno"],
    "effects": {
      "helpsWith": ["Dolor", "Depresión"],
      "feelings": ["Eufórico", "Creativo"]
    }
  },
  "variants": [
    {
      "name": "Blue Dream 1g",
      "price": 350000
    }
  ]
}

Información de Cultivo

Name
difficulty
Type
enum
Description
Dificultad de cultivo: easy, moderate, hard.
Name
floweringTime
Type
object
Description
Tiempo de floración en semanas.
Name
yield
Type
object
Description
Rendimiento esperado indoor/outdoor.
Name
height
Type
enum
Description
Altura de la planta: short, medium, tall.
Name
type
Type
enum
Description
Tipo de cultivo: indoor, outdoor, both.

Información de cultivo

{
  "growInfo": {
    "difficulty": "moderate",
    "floweringTime": {
      "min": 8,
      "max": 10
    },
    "yield": {
      "indoor": "400-500g/m²",
      "outdoor": "500-600g/planta"
    },
    "height": "medium",
    "type": "both",
    "notes": "Requiere podas regulares para control de altura. Resistente a moho."
  }
}

Próximos Pasos

API de Productos Catálogo de Cepas (Miembros)Interfaces TypeScript