Insertar objeto

Para insertar un objeto en cliente, se debe enviar un POST como el que se especifica a continuación.

POST https://api.persat.com.ar/v1/clientobjvalue

Headers

Name

Type

Description

Authorization*

String

Bearer API_KEY

Content-Type*

String

application/json

Request Body

Name

Type

Description

uid_client*

String

Identificador del cliente

obj_id*

Number

Identificador del esquema/plantilla del Objeto en cliente. Por ej: Puedeo tener tanto Heladeras como Matafuegos. Este obj_id es para identificar el tipo de objeto

fields*

Object

Los campos del objeto a insertar. Ver en el ejemplo en esta misma seccion

{
    "success": true,
    "data": {
        "uid_client": "AABC9098",
        "obj_id": 2,
        "fields": {
            "1": "AABCSA090AA",
            "4": "No frost",
            "3": "1500",
            "6": "",
            "7": "",
            "8": ""
        },
        "updated": "2022-05-19T19:15:11.000Z"
    }
}

{
    "success": false,
    "error": {
        "status": 400,
        "type": "BAD_REQUEST",
        "userMessage": "'field.1' es un campo string obligatorio que identifica el client obj value dentro del cliente"
    }
}

Ejemplo de request

En este ejemplo insertamos un elemento del tipo 2 (obj_id) en el cliente "AABC9098". Este obj_id representa el objeto Heladeras.

body

{
	"uid_client": "AABC9098",
	"obj_id": 2,
	"fields": {
		"1": "AABCSA090AA",
		"4": "No frost",
		"3": "1500"
	}
}

El field.1 es obligatorio y es el identificador de la heladera. Debe ser unico por cliente. Los otros campos son los que se corresponden a la plantilla/esquema (obj_id) y no son obligatorios.

Los valores a insertar son siempre strings, mas alla de que en la definición de la plantilla del objeto sean de tipo Numero, email, etc.

Por el momento, no se realizan validaciones durante la inserción o modificación de estos campos.

Analizando la Respuesta

En caso que no haya ningun error, obtenemos

{
    "success": true,
    "data": {
        "uid_client": "AABC9098",
        "obj_id": 2,
        "fields": {
            "1": "AABCSA090AA",
            "4": "No frost",
            "3": "1500",
            "6": "",
            "7": "",
            "8": ""
        },
        "updated": "2022-05-19T19:15:11.000Z"
    }
}

updated: Es la fecha de inserción o modificación en UTC

Notese que se reciben varios fields extra (6,7,8) que no enviamos durante la creación, pero que estan definidos en la plantilla del objeto. Entonces fueron completados con valor ""

Last updated 3 months ago

{ "success": true, "data": { "uid_client": "AABC9098", "obj_id": 2, "fields": { "1": "AABCSA090AA", "4": "No frost", "3": "1500", "6": "", "7": "", "8": "" }, "updated": "2022-05-19T19:15:11.000Z" } }

{ "success": false, "error": { "status": 400, "type": "BAD_REQUEST", "userMessage": "'field.1' es un campo string obligatorio que identifica el client obj value dentro del cliente" } }