Table of contents
TOC
Collapse the table of content
Expand the table of content
Última actualización: 25/07/2018

Códigos de error y de advertencia de la API de OneNote

Se aplica a: blocs de notas para consumidores de OneDrive | blocs de notas para empresa de Office 365

Este artículo describe los códigos de error y de advertencia que devuelve la API de OneNote cuando se produce un error en una solicitud enviada a través de la API.

Respuestas de advertencia y error

Cuando la solicitud genera un error, la API de OneNote deja de realizar la solicitud y devuelve una respuesta de error como un objeto JSON. Una respuesta de error contiene el código de error asociado, un mensaje y un vínculo a la sección correspondiente en este artículo. El ejemplo siguiente muestra el aspecto de una respuesta de error.

{
   "error":{
      "code":"10002",
      "message":"The service is currently unavailable. Please try again later.",
      "@api.url":"http://go.microsoft.com/fwlink/?LinkID=400805"
   }
}

Cuando su solicitud genera una advertencia, la API de OneNote realiza la solicitud e incluye la advertencia en su respuesta. Una respuesta puede contener más de una advertencia, por lo que la API devuelve advertencias como una matriz de objetos JSON. Cada advertencia contiene un mensaje y un enlace a la sección correspondiente de este artículo. El siguiente ejemplo muestra cómo se ve una respuesta de advertencia en el contexto de una solicitud completada.

{
   "@odata.context":"https://www.onenote.com/api/v1.0/$metadata#me/notes/notebooks",
   "api.diagnostics@odata.type":"#Collection(Microsoft.OneNote.Api.Diagnostic)",
   "@api.diagnostics":[
      {
         "message":"Created date/time string 5/5/2014 in 'Presentation' part html did not match any of the allowed formats",
         "url":"http://go.microsoft.com/fwlink/?LinkID=400816"
      }
   ],
   "value":[
      {
         "isDefault":false,
         "createdBy":null,
         "modifiedTime":"0001-01-01T00:00:00Z",
         "userRole":"Owner",
         "id":"55C9F7CBFC6AC1!76345",
         "name":"Notebook1",
         "link":null
      },
      {
         "isDefault":true,
         "createdBy":null,
         "modifiedTime":"0001-01-01T00:00:00Z",
         "userRole":"Owner",
         "id":"55C9F7CBFC6AC1!76428",
         "name":"Notebook2",
         "link":null
      },
      {
         "isDefault":false,
         "createdBy":null,
         "modifiedTime":"0001-01-01T00:00:00Z",
         "userRole":"Owner",
         "id":"55C9F7CBFC6AC1!77509",
         "name":"Notebook3",
         "link":null
      }
   ]
}

Una solicitud también puede generar un error y una o más advertencias. En ese caso, la API de OneNote deja de realizar la solicitud y devuelve tanto el error como las advertencias. El siguiente ejemplo muestra cómo se ve un error que contiene una advertencia.

{
   "error":{
      "code":"10002",
      "message":"The service is currently unavailable. Please try again later.",
      "@api.url":"http://go.microsoft.com/fwlink/?LinkID=400805",
      "api.diagnostics@odata.type":"#Collection(Microsoft.OneNote.Api.Diagnostic)",
      "@api.diagnostics":[
         {
            "message":"Created date/time string 5/5/2014 in 'Presentation' part html did not match any of the allowed formats",
            "url":"http://go.microsoft.com/fwlink/?LinkID=400816"
         }
      ]
   }
}

Si necesita trabajar con el soporte de Microsoft para resolver cualquier problema, asegúrese de también registrar el encabezado X-CorrelationId y la marca de hora de la llamada a la API.

Códigos de 10001 a 19999

El servicio tiene problemas o está enviando información a la aplicación.

10001

Se produjo un error inesperado y la solicitud ha fallado.

10002

El servicio no está disponible en este momento.

10003

La cuenta de usuario actual ha superado el número máximo de solicitudes activas. La aplicación tendrá que repetir la solicitud.

10004

El servicio no puede crear una página en la sección solicitada porque la sección está protegida por contraseña.

10005

La solicitud contiene más del número máximo de etiquetas de imagen en las que el atributo data-render-src contiene un PDF. Vea Agregar imágenes y archivos.

10006

La API de OneNote no pudo crear una página en la sección especificada porque esta sección está dañada.

10007

El servidor está demasiado ocupado para atender la solicitud entrante en este momento. Inténtelo de nuevo más tarde.

10008

Uno o más de las bibliotecas de documentos en OneDrive del usuario o del grupo contiene más de 5000 elementos de OneNote (blocs de notas, secciones, grupos de secciones) y no se puede consultar mediante la API. Asegúrese de que ninguna de las bibliotecas de documentos del grupo o del usuario contiene más de 5000 elementos de OneNote. Consulte el blog de desarrollo de OneNote para conocer los pasos de mitigación.

10012

No se puede crear ni actualizar la entidad porque la biblioteca que contiene el bloc de notas necesita extraer del repositorio los elementos antes de editarlos. Para obtener más información, vea https://support.office.com/en-us/article/Configure-a-site-library-to-require-check-out-of-files-f63fcbdc-1db6-4eb7-a3eb-dd815500c9e7.

Quite el requisito de desprotección de la biblioteca o mueva el bloc de notas.

10013

Uno o más de las bibliotecas de documentos en OneDrive del usuario o del grupo contiene más de 20 000 elementos y no se puede indexar para realizar consultas mediante la API. Asegúrese de que ninguna de las bibliotecas de documentos del grupo o del usuario contiene más de 20 000 elementos. Consulte el blog de desarrollo de OneNote para conocer los pasos de mitigación.

19999

Ha habido un error en la solicitud porque se produjo un error sin determinar.

Códigos de 20001 a 29999

El código de la aplicación ha hecho algo mal.

20001

Falta la parte "Presentación", necesaria en la solicitud. Se necesita exactamente una. Consulte Referencia de la API de OneNote.

20002

La solicitud contiene dos o más partes "Presentación". Se necesita exactamente una. Consulte Referencia de la API de OneNote.

20003

El tipo de contenido de la parte "Presentación" solo puede ser texto/html o aplicación/XHTML+XML. Consulte Referencia de la API de OneNote.

20004

El HTML de la parte "Presentación" contiene una etiqueta de imagen con ambos conjuntos de propiedades: src y data-render-src. La API omitirá la propiedad src y usará la propiedad data-render-src. Consulte Referencia de la API de OneNote.

20005

El URI de la solicitud es demasiado largo. El tamaño máximo del URI (incluyendo todos los parámetros y datos) es de 16 KB o 16 384 caracteres.

20006

El HTML de la parte "Presentación" contiene una etiqueta de imagen sin los conjuntos de propiedades src o data-render-src. La API omitirá la etiqueta imagen. Consulte Referencia de la API de OneNote.

20007

El código HTML de la parte "Presentation" contiene una cadena de fecha y hora de creación que no coincide con ninguno de los formatos permitidos. Consulte Referencia de la API de OneNote.

20008

El tamaño de la solicitud es demasiado grande. Consulte Referencia de la API de OneNote.

20009

La solicitud contiene partes con nombres duplicados. Los nombres de las partes deben ser únicos. Consulte Referencia de la API de OneNote para obtener más información sobre cómo construir solicitudes de varias partes.

20010

No se proporcionó el encabezado Content-Disposition para el tipo de contenido especificado. Consulte Referencia de la API de OneNote para obtener más información sobre cómo construir solicitudes de varias partes.

20011

La solicitud contiene una carga de varias partes con formato incorrecto. Entre los problemas se incluyen la falta de líneas en blanco, falta de la última línea, separadores de partes con formato incorrecto, etc. Si va a crear el mensaje de varias partes a mano, revise cuidadosamente la lógica o considere el uso de una biblioteca de terceros. Consulte Referencia de la API de OneNote para obtener más información sobre cómo construir una carga útil de varias partes.

20012

La solicitud no proporciona un tipo de contenido para la parte especificada. Consulte Referencia de la API de OneNote para más información sobre cómo construir una parte.

20013

La solicitud no proporciona los encabezados Content-Type y Content-Disposition para la parte especificada.

20014

La longitud de una parte en el mensaje de varias partes supera el tamaño máximo de 25 MB. Consulte Referencia de la API de OneNote.

20015

El recuento de partes en el mensaje de varias partes supera el límite de 500. Consulte Referencia de la API de OneNote.

20016

La longitud del mensaje de varias partes supera el límite de 75 MB. Consulte Referencia de la API de OneNote.

20100

Hay algún fallo en la sintaxis de su solicitud. Consulte Referencia de la API de OneNote para más información, y asegúrese de haber construido la solicitud correctamente.

20101

La propiedad que ha solicitado no existe.

20102

Ha solicitado un recurso que no existe.

20103

La consulta expand no se admite para esta solicitud. Vea Opciones de cadena de consultas OData admitidas.

20104

La opción de consulta pagelevel solo se admite al realizar consultas para la colección de páginas de una sección o de una página específica. Por ejemplo:

GET ../sections/{id}/pages?pagelevel=true

GET ../pages/{id}?pagelevel=true

20106

La solicitud contiene un operador de consulta que no es compatible. Consulte Referencia de la API de OneNote.

20108

La solicitud contiene parámetros de consulta de OData no compatibles.

20109

La carga útil de la solicitud PATCH no se ha creado correctamente.

20110

Las solicitudes de creación de la página con partes de datos requieren que el contenido tenga varias partes, con una parte "Presentación". Consulte Referencia de la API de OneNote.

20111

La solicitud usa una característica de OData que no es compatible.

20112

Su solicitud contiene un identificador no válido para el bloc de notas de destino, el grupo de sección, la sección o la entidad de la página.

20113

Se ha eliminado el recurso especificado en la solicitud.

20115

El nombre contiene caracteres no válidos. El nombre de un bloc de notas no puede contener ninguno de los siguientes caracteres: ? * \ / : < > | ' "

20117

Ya existe un elemento con el nombre especificado en la ubicación indicada.

20119

El código HTML de la parte "Presentation" contiene un atributo data-attachment que no tiene un formato válido o que incluye uno o varios de estos caracteres no válidos para un nombre de archivo: \ / : * ? < > | ". La solicitud sustituye el valor indicado en el mensaje de error.

20120

Su solicitud especifica un destino PATCH que no se encuentra.

20121

La solicitud contiene un argumento PATCH no válido. Consulte Actualizar contenido de la página.

20122

La solicitud especifica una acción PATCH no compatible. Consulte Actualizar contenido de la página.

20123

La solicitud PATCH no puede modificar la página especificada.

20124

La solicitud PATCH de varias partes no incluye una parte "commands" con la estructura JSON de la acción PATCH. Vea Actualizar contenido de la página.

20125

La solicitud PATCH no contiene acciones. Consulte Actualizar contenido de la página.

20126

El cuerpo del mensaje contiene JSON con un formato incorrecto o campos que no son compatibles con esta operación.

20127

La solicitud especifica el nombre de una propiedad desconocida.

20128

La solicitud contiene un error de sintaxis de OData en la posición indicada en el mensaje.

20129

La solicitud contiene una opción de la cadena de consulta top cuyo valor es demasiado alto. Para las consultas de páginas, el valor máximo es 100 y el valor predeterminado es 20.

20130

La solicitud contiene un URI que apunta a un recurso de HTTP que no se encuentra.

20131

La solicitud contiene un valor no válido para Content-Type. Use el valor indicado en el mensaje. Consulte Referencia de la API de OneNote.

20132

Su solicitud incluye contenido no válido. Las causas comunes son la falta de un encabezado Content-Type o un cuerpo de la solicitud sin contenido. Consulte Referencia de la API de OneNote.

20133

Su solicitud especifica un destino PATCH que no es compatible. Vea Actualizar contenido de la página.

20134

La solicitud especifica un elemento no válido como destino de la acción PATCH. Si el destino usa el identificador data-id, asegúrese de que tenga el símbolo # como prefijo. Consulte Actualizar contenido de la página.

20135

Su solicitud especifica un tipo de entidad que no es compatible con la operación PATCH. Vea Actualizar contenido de la página.

20136

La solicitud contiene un atributo data-render-src o data-render-method no válido o que falta. Vea Extraer los datos de las capturas.

20137

La página de destino no admite solicitudes PATCH.

20138

El tipo de elemento de destino de la solicitud PATCH no admite la acción append especificada. Consulte Actualizar contenido de la página.

20139

La solicitud contiene un valor de atributo data-tag no válido. Vea Usar etiquetas de nota.

20140

La solicitud contiene un valor de estado data-tag no válido. Las etiquetas de nota de casillas pueden tener un estado completed. Ejemplo:

<p data-tag="to-do:completed">To-do note tag in completed state (checked box in the UI)</p>

Vea Uso de etiquetas de nota.

20141

El destino de la solicitud PATCH no admite la acción especificada. Vea Actualizar contenido de la página.

20142

La solicitud contiene una expresión expand para un elemento primario de entidades secundarias o un elemento secundario de entidades primarias, lo cual no es compatible. Vea Opciones de cadena de consultas OData admitidas.

20143

La consulta OData no es válida.

20144

La solicitud contiene una expresión expand para una propiedad de no navegación. Únicamente se pueden expandir las propiedades de navegación.

20145

La expresión select o expand de la solicitud contiene un término no válido.

20146

El atributo style="position:absolute" se especifica en un elemento, pero el elemento body no especifica data-absolute-enabled="true", que es necesario para admitir el posicionamiento. Se omitirán todas las configuraciones de posición. Vea Crear elementos con posición absoluta.

20147

El atributo style="position:absolute" se especifica en un elemento que no es un elemento secundario directo del elemento body, que no es compatible. Si el elemento es un div, img **u **object, haga que sea un elemento secundario directo del cuerpo; en caso contrario, se pasarán por alto los valores de posición y representará su contenido dentro de un div de posición absoluta Vea Crear elementos con posición absoluta.

20148

El atributo style="position:absolute" se especifica en un tipo de elemento que no es compatible. Solo div, img y object admiten la posición de los elementos que son elementos secundarios directos del cuerpo de la página. Vea Crear elementos con posición absoluta.

20149

Su solicitud especifica un elemento de destino que no se encuentra.

20150

La solicitud no es válida para este tipo de autenticación. Use la ruta de acceso ../me/notes/ en su lugar.

20151

La solicitud no es válida para este tipo de autenticación. Use el punto de conexión ../me/notes/section/{id}/pages para crear una página en una sección específica.

20152

No hay ningún valor name especificado para la entidad. El nombre debe estar definido y no puede contener solo espacios en blanco.

20153

El nombre de la entidad contiene caracteres no válidos. El nombre de la organización no puede contener los siguientes caracteres: ? * \ / : < > | & # " % ~

20154

El nombre de la entidad no puede comenzar con un espacio.

20155

El nombre de entidad es demasiado largo. Los nombres de los blocs de notas tienen un límite de 128 caracteres. Los nombres de otras entidades tienen un límite de 50 caracteres.

20156

El identificador especificado para el recurso de destino no existe.

20157

El identificador especificado para la entidad de destino no es válido.

20158

No se pueden obtener los metadatos de la dirección URL del sitio especificada en la solicitud. Compruebe el formato de la dirección URL suministrada. Los formatos admitidos son https://domain.sharepoint.com/site-a y https://domain.com/sites/site-a.

20160

No se puede encontrar un grupo de Office 365 con el id. especificado.

20161

El contexto no especifica ningún Id. de usuario válido. Un error frecuente es que PUID/CID se ha pasado como un long en lugar de un hex.

20166

La aplicación ha emitido demasiadas solicitudes en nombre de un usuario en un corto período de tiempo. Para ayudar a garantizar que la API de OneNote permanece estable y con capacidad de respuesta, la API devuelve un código de estado 429 y este error cuando detecta que una aplicación está usando demasiados recursos. Para obtener más información, consulte OneNote API throttling and how to avoid it (Limitación de la API de OneNote y cómo evitarla).

20168

No se admite el origen de vídeo especificado en la solicitud. Vea Sitios de vídeo compatibles para obtener la lista actual.

Códigos de 30001 a 39999

Hay algún fallo en la cuenta del usuario.

30101

La cuenta de usuario ha excedido su cuota de OneDrive. Vea OneDrive.

30102

No se puede agregar nada más a la sección solicitada porque ha alcanzado su tamaño máximo.

30103

El consumo de recursos es demasiado alto para la solicitud. La cuenta de usuario de destino tiene un gran conjunto de datos o el servicio está recibiendo un gran número de solicitudes simultáneas para el mismo sitio (por ejemplo, el sitio personal del usuario o un sitio de grupo).

30104

Se ha suspendido la cuenta de usuario.

30105

No se ha aprovisionado el OneDrive for Business del usuario, que es necesario para los portátiles de acceso. El servicio de OneNote aprovisionará el sitio ahora. Este proceso puede tardar varios minutos.

30106

OneDrive for Business se está aprovisionando para el usuario.

30108

No se pudo recuperar el OneDrive for Business personal del usuario. Aquí hay algunas causas posibles.

MotivoSolución
No se ha aprovisionado el sitio personal del usuario.El usuario debe abrir OneDrive for Business y seguir las instrucciones para crear el sitio. Si esto no funciona, deben ponerse en contacto con su administrador de inquilinos de Office 365.
Actualmente se está aprovisionando el sitio personal del usuario.Intente de nuevo la solicitud más tarde.
El usuario no tiene un OneDrive válido para la licencia de la empresa.El usuario debe ponerse en contacto con su administrador de inquilinos de Office 365.
Un problema de red ha impedido que la solicitud se enviase correctamente.Intente de nuevo la solicitud más tarde.

Códigos de 40001 a 49999

El usuario o la aplicación no tienen los permisos correctos.

40001

La solicitud no contiene un token válido de OAuth. Consulte Autenticación y permisos de OneNote.

40002

El usuario no tiene permiso para escribir en la ubicación solicitada.

40003

El usuario no tiene permiso para acceder al recurso solicitado.

40004

El token de OAuth no tiene los ámbitos necesarios para realizar la acción solicitada. Consulte Autenticación y permisos de OneNote.

Encabezado X-CorrelationId

Además de los códigos de respuesta HTTP estándar, la API de OneNote devuelve los encabezados a la aplicación que realiza la llamada. En cada respuesta hay incluido un encabezado X-CorrelationId y un encabezado Date, como se muestra en el siguiente extracto:

X-CorrelationId: d2d6aaf5-3bde-4ee7-ba18-27727bf3cffe
Date: Fri, 06 Mar 2015 15:10:46 GMT

El identificador de correlación es un GUID que une las diferentes partes de los servidores back-end. Los identificadores de correlación no son secuenciales, lo que significa que no puede usarlos para establecer un orden de creación de páginas.

Su aplicación puede registrar el identificador de correlación y la fecha de las llamadas de API. Puede usar estos valores si necesita trabajar con la asistencia de Microsoft para resolver problemas en su aplicación o con la API.

Recursos adicionales

© 2018 Microsoft