Insertar elemento

Para insertar un elemento en una Master Db en Persat, se debe enviar un POST como el que se especifica a continuación.

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

Headers

Name
Type
Description

Authorization*

String

Bearer API_KEY

Content-Type*

String

application/json

Request Body

Name
Type
Description

mdb_id*

Number

Identificador de la Master Db. Por ejemplo Productos

fields*

Object

JSON Object con los campos del elemento a insertar. 

{
    "success": true,
    "data": {
        "mdb_id": 4,
        "fields": {
            "1": "DEST-123AALK",
            "2": "Destornillador perillero",
            "5": "Rojo"
            "6": ""
        },
        "updated": "2022-05-20T13:43:46.000Z"
    }
}

Ejemplo de request

En este ejemplo insertamos un elemento en la Master db de Productos (mdb_id: 4). El fields.1 es obligatorio y debe ser único, ya que pasa a ser el identificador del elemento insertado.

body

{
    "mdb_id": 4,
    "fields": {
        "1": "DEST-123AALK",
        "2": "Destornillador perillero",
        "5": "Rojo"
    }
}

Los valores a insertar son siempre strings, mas alla de que en la definición de la Master db sean de tipo Número, email, link, 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": {
        "mdb_id": 4,
        "fields": {
            "1": "DEST-123AALK",
            "2": "Destornillador perillero",
            "5": "Rojo"
            "6": ""
        },
        "updated": "2022-05-20T13:43:46.000Z"
    }
}

La respuesta contiene al elemento insertado como se puede ver en Obtener elemento

Nótese que la Master Db tiene definido un field "6", que no enviamos durante la inserción, pero si lo recibimos en la respuesta como vacío ""

El único campo de los fields obligatorio es el fields.1 ya que es el identificador unico del elemento en la db

Last updated