Loading...

Aviso:

Para brindarle información de soporte completa de manera más rápida, el contenido de esta página ha sido traducido al español mediante traducción automática. Para consultar la información de soporte más precisa, consulte la versión en inglés de este contenido.

Data Store

Catalyst Data Store es un sistema de gestión de bases de datos relacionales basado en la nube que almacena los datos persistentes de tu aplicación en forma de tablas.

Las APIs de Data Store te permiten insertar y gestionar registros en las tablas del Data Store de tu proyecto, obtener detalles de tablas y columnas, e incluso realizar acciones de lectura y escritura masiva. Sin embargo, solo puedes crear una tabla y su esquema desde la consola de Catalyst.

Insertar una nueva fila en una tabla

Descripción

Esta API te permite insertar una nueva fila de datos o un registro en una tabla de Data Store, haciendo referencia al ID único o nombre de la tabla.

Debes pasar los nombres de las columnas y sus valores correspondientes para el registro en un array JSON en la solicitud, como se describe a continuación.

Nota:

  • La tabla y las columnas deben estar creadas previamente. Puedes crear una tabla y las columnas desde la consola.

  • Podrás insertar hasta 5000 registros en cada tabla por proyecto en el entorno de desarrollo. Puedes crear hasta 25,000 registros en total en cada proyecto en el entorno de desarrollo. No hay límites superiores para la creación de registros en el entorno de producción.

Detalles de la solicitud

URL de solicitud

POST

{api-domain}/baas/v1/project/{project_id}/table/{tableIdentifier}/row

copy

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

project_id
Numerical
El ID único del proyecto

tableIdentifier
Numerical
El ID único de la tabla o el nombre de la tabla

Encabezados de solicitud

Authorization: Zoho-oauthtoken {oauth_token}
Content-Type: application/json

Encabezados opcionales

CATALYST-ORG: {org_id}

Environment: Development

Scope

ZohoCatalyst.tables.rows.CREATE

Nota: Esta operación también se puede ejecutar con permisos de autenticación de usuario de Catalyst usando los SDKs de Catalyst. Consulta la sección Requisitos previos de Catalyst API para más detalles.

Array JSON de solicitud

Debes enviar los nombres de las columnas y sus valores correspondientes en un array JSON de esta manera:

copy
{
    "column1_name": "column1_value",
    "column2_name": "column2_value",
    "column3_name": "column3_value",
    .
    .
}

donde column_name es el nombre de una columna única en la tabla, y column_value es su valor correspondiente en el registro.


Nota: Debes enviar al menos un par de nombre y valor de columna para insertar en el registro.

Detalles de la respuesta

La respuesta contendrá los metadatos de la fila que se creó, como su ROWID y CREATEDTIME, y los nombres clave de las columnas y los valores que se insertaron.

Sample Request
copy

curl -X POST \ https://api.catalyst.zoho.com/baas/v1/project/4000000006007/table/EmpDetails/row
-H “Authorization: Zoho-oauthtoken 1000.910*************************16.2f*************************57”
-H “Content-Type:application/json”
-d ‘[ { “Department_ID”:“IT678”, “Department_Name”:“Marketing”, “Employee_Name”:“Robert Page” } ]’

Sample Response
copy
{
"status": "success",
"data": [
    {
        "CREATORID": "12096000000003003",
        "MODIFIEDTIME": "2023-06-05 11:35:14:332",
        "Department_ID": null,
        "Employee_Name": "Robert Page",
        "Department_Name": "Marketing",
        "CREATEDTIME": "2023-06-05 11:35:14:332",
        "ROWID": 12096000000642928
    }
]

}