Objeto de parche

Objeto de parche #

Actualiza un conjunto específico de propiedades de un elemento de directorio. Para ello, se utiliza el atributo JSON Formato de parche para cualquier cambio.

PATCH /v1.0/directorios de contactos/{DIRECTORY_ID}/items/{DIRECTORY_ITEM_ID}

Ejemplo #

Esta solicitud agregará un nuevo campo de teléfono a un elemento de directorio existente.

Pedir # 

PATCH <https://api.na.myreports.cloud/api/v1.0/contactdirectories/00000000-0000-0000-0000-000000000000/items/00000000-0000-0000-0000-000000000123> HTTP/1.1
Tipo de contenido: application/json
accept-charges: true
Autorización: portador {TOKEN}
Conexión: keep-alive
{
    "ruta": "/fields/phone2",
    "op": "agregar",
    "valor": "+44YYYYYYYYYYY"
}

Respuesta # 

HTTP/1.1 201 Creado
Tipo de contenido: application/json; charset=utf-8
Longitud del contenido: xx
Ubicación: <https://api.na.myreports.cloud/api/v1.0/contactdirectories/00000000-0000-0000-0000-000000000000/items/00000000-0000-0000-0000-000000000123>
{
	"datos": {
        "id": "00000000-0000-0000-0000-000000000123",
        "campos": {
            "title": "Sr",
            "fullName": "CRM3a",
            "companyName": "Empresa",
            "jobTitle": "Título del trabajo",
            "phone1": "+44XXXXXXXXXX",
            "phone2": "+44YYYYYYYYYYY",
            "email": "Dirección de correo electrónico",
            "campo1": "campo1",
            "campo2": "campo2",
            "crmId": "00000000-0000-0000-0000-00000000000001"
        }
    },
	"status": "éxito",
	"timestamp": "2019-11-29T16:03:23.9251680Z"
}

Errores #

Desautorizado #

Cuando el token no se proporciona, no es válido o ha caducado 

HTTP/1.1 401 No autorizado

Mala solicitud #

Cuando el identificador de elemento de directorio proporcionado no está en el formato correcto 

HTTP/1.1 400 Solicitud incorrecta
Fecha: Thu, 06 Feb 2020 12:45:27 GMT
Tipo de contenido: application/json; charset=utf-8
Longitud del contenido: 149
{
	"error": 400,
	"message": "El valor '<tenant id>' no es válido.",
	"status": "error",
	"timestamp": "2020-02-06T12:45:27.5903465Z"
}

No encontrado #

Cuando no hay elementos de directorio que tengan un identificador coincidente 

HTTP/1.1 404 No encontrado
Fecha: Thu, 06 Feb 2020 12:46:58 GMT
Tipo de contenido: application/json; charset=utf-8
Contenido-Longitud: 95
{
	"error": 404,
	"message": "No encontrado",
	"status": "error",
	"marca de tiempo": "2020-02-06T12:46:58.7669535Z"
}