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

200: OK La consulta se ejecutó con éxito

{
    "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"
    }
}

400: Bad Request Error en alguno de los campos enviados. userMessage contiene informacipon adicional.

{
    "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"
    }
}

409: Conflict Ya existe un Objeto en este cliente con el mismo identificador

Ejemplo de request

En este ejemplo insertamos un elemento del tipo 2 (obj_id) en el cliente "AABC9098". Este objid 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 definicion 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 insercion o modificacion 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 ""