---
title: "Insertar par clave-valor en segmento de cache"
url: https://docs.catalyst.zoho.com/es/api/code-reference/cloud-scale/cache/insert-key-value-in-segment/
description: "Esta API te permite insertar un par clave-valor como elemento de cache en un segmento de cache."
last_updated: 2026-03-20T16:21:56Z
service: Cloud Scale
type: api
---

# Cache

[Catalyst Cache](https://docs.catalyst.zoho.com/es/cloud-scale/help/cache/introduction/) es un componente de almacenamiento en memoria pequeño que te permite almacenar datos a los que tu aplicación de Catalyst accede con frecuencia.

El cache de Catalyst se divide en particiones o unidades de cache llamadas segmentos. Cada segmento almacena elementos de cache en forma de pares clave-valor.

# Insertar un par clave-valor en un segmento de cache

### Descripción

Esta API te permite insertar un par clave-valor como elemento de cache en un segmento de cache. El segmento se identifica por su ID único. La clave representa el atributo y el valor es el dato del elemento de cache.

También puedes especificar opcionalmente el tiempo de expiración del elemento de cache. La validez predeterminada y máxima de un elemento de cache es de dos días.

> **Nota:**El segmento de cache debe estar creado previamente. Puedes [crear un segmento](https://docs.catalyst.zoho.com/es/cloud-scale/help/cache/implementation/#create-a-segment) desde la consola de Catalyst o usar el segmento predeterminado.

### Detalles de la solicitud

#### URL de solicitud

`POST` {api-domain}/baas/v1/project/{project_id}/segment/{segment_id}/cache

- **api-domain** (URL): El dominio específico del DC para acceder a Catalyst API

- **project_id** (Numerical): El [ID único](https://docs.catalyst.zoho.com/es/getting-started/set-up-a-catalyst-project/general-settings/) del proyecto

- **segment_id** (Numerical): El [ID único](https://docs.catalyst.zoho.com/es/cloud-scale/help/cache/implementation/#create-a-segment) del segmento de cache 

#### Encabezados de solicitud
 **Authorization:** Zoho-oauthtoken {oauth_token} 

**Content-Type:** application/json

**Encabezados opcionales** 

 **CATALYST-ORG:** {org_id}

 **Environment:** Development

#### Scope

ZohoCatalyst.cache.CREATE

#### Propiedades JSON de la solicitud

- **cache_name** (string, mandatory):  Nombre de la clave del segmento de cache 
 Tamaño máximo: 50 caracteres   

- **cache_value** (string, mandatory):  Valor de datos que representa la clave 
 Tamaño máximo: 16000 caracteres  

- **expiry_in_hours** (long, optional):  Duración de expiración en horas 
 Tamaño máximo: 48   

### Detalles de la respuesta

La respuesta devolverá los detalles del elemento de cache como `cache_name`, `cache_value` y `expires_in`, junto con los detalles del segmento en el que se insertó.

**Sample Request**

```bash
curl -X POST \
https://api.catalyst.zoho.com/baas/v1/project/4000000006007/segment/3376000000425030/cache \
-H "Authorization: Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57" \
-H "Content-Type:application/json" \
-d '{
"cache_name":"counter",
"cache_value":"125",
"expiry_in_hours":24
      }'

```

**Sample Response**

```json

    {
    "status": "success",
    "data": {
        "cache_name": "counter",
        "cache_value": "125",
        "project_details": {
            "id": 4000000006007,
            "project_name": "ShipmentTracking",
            "project_type": "Live"
        },
        "segment_details": {
            "id": 3376000000425030,
            "segment_name": "CustomerLocation"
        },
        "expires_in": "Mar 28, 2019 02:03 AM",
        "expiry_in_hours": 24,
        "ttl_in_milliseconds": 86400000
    }
    }
```

### SDK Documentation

[Insert Key-Value Pair- Java SDK](https://docs.catalyst.zoho.com/es/sdk/java/v1/cloud-scale/cache/insert-data-into-cache)</br></br>
[Insert Key-Value Pair- Node.js SDK](https://docs.catalyst.zoho.com/es/sdk/nodejs/v2/cloud-scale/cache/insert-data-into-cache)</br></br>
[Insert Key-Value Pair- Python SDK](https://docs.catalyst.zoho.com/es/sdk/python/v1/cloud-scale/cache/insert-data-into-cache)
</br></br>