Modificar elemento

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

PUT https://api.persat.com.ar/v1/masterdbvalues/mdb_id/field_1

Path Parameters

Name	Type	Description
mdb_id*	Number	Identificador de la Master db
field_1*	String	Identificador del elemento a modificar

Headers

Name	Type	Description
Authorization*	String	Bearer API_KEY
Content-Type*	String	application/json

Request Body

Name	Type	Description
fields*	Object	JSON Object con los campos del elemento a insertar.

200: OK La consulta se ejecutó con éxito

404: Not Found La master db especificada no existe

{
    "success": false,
    "error": {
        "status": 404,
        "type": "NOT_FOUND",
        "userMessage": "No existe el mdb_id: 2313213"
    }
}

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

{
    "success": false,
    "error": {
        "status": 400,
        "type": "BAD_REQUEST",
        "userMessage": "'mdb_id' es un number (entero) obligatorio"
    }
}

409: Conflict Conflicto. Quiero modificar el field_1 y ya existe otro elemento con este mismo field_1

{
    "success": false,
    "error": {
        "status": 409,
        "type": "CONFLICT",
        "userMessage": "No se pudo modificar el field_1 del mb value, ya que existe otro con ese mismo identificador: 'pinza'"
    }
}json

Ejemplo de request

En este ejemplo vamos a modificar un campo de un elemento particular. Pero no vamos a modificar su identificador (fields.1), aunque podríamos hacerlo si enviamos ese dato en el body.

• mdb_id: 4

• field_1 (Identificador del elemento): DEST-123AALK

Asi sería la consulta

PUT - https://api.persat.com.ar/v1/masterdbvalues/4/DEST-123AALK

body

{
    "fields": {
        "5": "Naranja"
    }
}

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 los 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": "Naranja"
            "6": ""
        },
        "updated": "2022-05-20T14:23:24.000Z"
    }
}

La respuesta contiene al elemento modificado y tiene la misma estructura que lo que se recibe en la sección Obtener elemento