API de OneNote
Use nuestro nuevo sitio de documentación. Contiene material para que pueda trabajar con las API de clientes y empresas de OneNote.
**Última modificación:**miércoles, 18 de noviembre de 2015
**Hace referencia a:**OneNote service
Bienvenido a nuestra API. La API de Microsoft OneNote permite a los desarrolladores escribir aplicaciones en muchas plataformas y tipos de dispositivos diferentes que crean y manipulan información del usuario almacenada en Microsoft OneNote. Este tema presenta una lista de las últimas actualizaciones que hemos hecho en la API y la documentación.
Si tiene preguntas u otros comentarios sobre la API o la documentación, únase a nosotros en las comunidades que encontrará casi al final del tema Introducción a la API de OneNote. Esperamos tener noticias suyas y que la API y la documentación le resulten útiles.
Nota
Suscríbase a la página de OneNote en API Changelog y manténgase informado de los cambios en nuestra API y su documentación.
Cambios en la API y la documentación de OneNote
Septiembre de 2015
El número máximo de páginas que se devuelven en una solicitud GET pages con la opción de consulta $top cambió de 500 a 100.
Julio de 2015
Editadas dos aplicaciones de muestra de explorador para la API de REST OneNote:
Editado ELIMINAR páginas a la producción.
Actualizada la dirección URL del servicio raíz en los temas de ayuda para usar la nueva ruta recomendada /me/notes/: https://www.onenote.com/api/v1.0/me/notes/
Junio de 2015
Publicado el tema Usar etiquetas de nota.
Mayo de 2015
Se refactorizaron códigos de error y se actualizó el tema Códigos de error y advertencia.
Se quitaron: 20103, 20104, 20105, 20114, 20116, 20118
Se agregaron: 20150, 20151, 20152, 20153, 20154, 20155, 20156, 20157, 20158
Se cambió: 20115 (se cambió el conjunto de caracteres no válidos para el nombre de un bloc de notas)
Si se están administrando errores relacionados con la validación de nombre de entidad, esto puede ser un cambio importante. La tabla siguiente muestra cómo controlar los cambios.
En el código, reemplace este código de error... |
por este código de error |
|---|---|
20105 (SectionNameEmpty) |
20152 (EntityNameEmpty) |
20104 (SectionNameInvalidChar) |
20153 (EntityNameInvalidChar) |
20118 (SectionNameInvalidStart) |
20154 (EntityNameInvalidStart) |
20103 (SectionNameTooLong) |
20155 (EntityNameTooLong) |
Abril de 2015
Se incluyó la REVISIÓN en la versión de producción. Se publicó el tema Actualizar contenido de la página.
Febrero de 2015
Se publicaron las siguientes API para la producción:
Consulta de página
Búsqueda de texto completo
Recuperar contenido de páginas
Crear elementos con posición absoluta
Se publicaron los artículos HTML de entrada y salida para páginas de OneNote y Crear páginas con elementos con posición absoluta y se actualizó Obtener contenido y estructura de OneNote. Se publicó información relacionada den el Blog del desarrollador de OneNote y Referencia interactiva de la API de OneNote.
Enero de 2015
Se publicó la muestra de la aplicación para Windows Universal en GitHub. Se emitió la tarjeta de presentación, URL de receta y API de extracción de URL de producto y la compatibilidad con la opción de cadena de consulta de expand. Se publicaron los artículos Enriquecer contenido capturado y Recuperar objetos en la jerarquía de bloc de notas.
Octubre de 2014
Hemos cambiado la documentación de referencia a nuestra nueva consola interactiva de la API de OneNote.
Julio de 2014
Hemos agregado estas referencias para ofrecer más capacidades:
Secciones GET de OneNote
Secciones GET de OneNote/identificador
Grupos de secciones GET de OneNote
Grupos de secciones/identificador GET de OneNote
Blocs de notas GET de OneNote
Blocs de notas/identificador GET de OneNote
Blocs de notas POST de OneNote
Blocs de notas/identificador/secciones POST de OneNote
Junio de 2014
Formato renovado de la sección de referencia de la API de OneNote.
Pequeña actualización en la semana del 29 de abril de 2014
En la primera actualización, completamos un par de prácticas funciones para desarrolladores que escribían aplicaciones que funcionan con documentos PDF o que querían que las capturas fueran a una sección de blocs de notas concreta:
Generación de archivos PDF como imágenes directamente en la página de OneNote. Con esta actualización, cuando agrega un <img data-render-src="name:BlockOfPDFData"/>, la API de OneNote representa las páginas PDF como imágenes y las inserta en la página. Es habitual insertar el archivo PDF en la página, y esto se puede hacer con la etiqueta <object data-render-src="name:BlockOfPDFData"/>. También puede hacer referencia al mismo BlockOfPDFData para ambas etiquetas. Antes de esta actualización, el archivo se podía insertar en la página, pero no se podían representar las imágenes de los mismos datos PDF. Para obtener más información, consulte el artículo sobre cómo Capturar e insertar archivos PDF con la API de OneNote.
Crear páginas en secciones específicas incluyendo el parámetro de consulta sectionName en las solicitudes POST de páginas. Si no existe el nombre de la sección de nivel superior que indica, la API lo creará. Con esta nueva función, la aplicación puede almacenar capturas en una sección fácilmente reconocible. Más información en Capturar páginas de una sección determinada usando la API de OneNote.
Hemos hecho estos cambios en la documentación:
Hemos agregado un artículo sobre Capturar e insertar archivos PDF con la API de OneNote, así como información de referencia.
Hemos agregado un artículo sobre Capturar páginas de una sección determinada usando la API de OneNote, así como información de referencia.
Hemos aclarado los límites relacionados con las imágenes y los archivos incrustados en los artículos sobre Compatibilidad de etiquetas HTML con páginas y Capturar fotos e imágenes con la API de OneNote.
Hemos actualizado la página de compatibilidad con la etiqueta HTML de la API de OneNote con algunas etiquetas compatibles de OneNote que no se habían documentado.
Lanzamiento inicial del 17 de marzo de 2014
Estos son los aspectos más destacados de la API de OneNote:
La API versión 1.0 ya está disponible. El extremo REST principal es https://www.onenote.com/api/v1.0. La única ruta de acceso a recursos disponible en estos momentos es /pages, pero tenemos pensado agregar más.
En la versión inicial, la API permite crear nuevas páginas de OneNote usando HTML para definir la página. Puede incluir imágenes e insertar otros tipos de archivos binarios (hasta 25 MB por archivo, 75 MB por página en total) en cada página de OneNote. La API puede tomar una instantánea de las páginas web e incluir la página como una imagen de la página de OneNote. También realiza OCR en las imágenes que su aplicación capture.
Para que su aplicación pueda funcionar, necesita tener un identificador de cliente o, si está creando una aplicación de la Tienda Windows 8, necesita un identificador del paquete. Encontrará información completa en Obtener un identificador de cliente para usarlo con la API de OneNote.
Además, la API de OneNote necesita que el usuario de su aplicación tenga una cuenta de Microsoft. No tienen que usar un dispositivo Microsoft, pero sí una cuenta de Microsoft. Para obtener más información sobre cómo usar el SDK de Windows Live Connect, consulte Autenticar usuarios para la API de OneNote.
El conjunto inicial de documentación incluye las siguientes secciones:
Introducción a la API de OneNote Ofrece una breve introducción a la API y muestra lo fácil que es usarla. Esta sección también incluye tutoriales para las principales plataformas de aplicaciones para que pueda empezar rápidamente.
Desarrollar con la API de OneNote Incluye fragmentos de código e información sobre las cosas que querrá hacer a medida que aprenda la API y trabaje con ella.
Consola interactiva de Apigee.com le permite jugar con la API de apigee.com.
Sus comentarios sobre los problemas que encuentre en los documentos y si le ofrecen lo que necesita siempre son bienvenidos. La API está destinada a desarrolladores de aplicaciones con y sin experiencia y nos gustaría que nos dijera cómo lo estamos haciendo.