API OneNote

Veuillez utiliser notre nouveau site de documentation. Il comporte du contenu sur l’utilisation des API OneNote destinées aux particuliers et aux entreprises.

**Dernière modification :**mercredi 18 novembre 2015

**S’applique à :**OneNote service

Bienvenue dans notre API. L’API Microsoft OneNote permet aux développeurs de créer des applications sur différents types de plateforme et périphérique qui créent et manipulent les informations de l’utilisateur stockées dans Microsoft OneNote. Cette rubrique présente une liste actualisée des dernières mises à jour que nous avons apportées à l’API et la documentation.

Si vous avez des questions concernant l’API ou la documentation, n’hésitez pas à rejoindre les communautés mentionnées au bas de la rubrique Prise en main de l’API OneNote. Nous espérons que l’API et la documentation vous seront utiles.

Modifications apportées à la documentation OneNote et à l’API

Septembre 2015

Le nombre maximal de pages renvoyées dans une demande GET pages à l’aide de l’option de requête $top est passé de 500 à 100.

Juillet 2015

Released two OneNote REST API explorer sample apps:

• iOS REST API Explorer

• Android REST API Explorer

Released DELETE pages to production.

L’URL du service racine a été mise à jour dans la rubrique de procédures pour utiliser le nouveau chemin recommandé /me/notes/ : https://www.onenote.com/api/v1.0/me/notes/

Juin 2015

Publication de la rubrique Utiliser des balises de note.

Mai 2015

Codes d’erreur refactorisés et mise à jour de la rubrique Codes d’erreur et d’avertissement.

  Supprimé : 20103, 20104, 20105, 20114, 20116, 20118
  Ajouté : 20150, 20151, 20152, 20153, 20154, 20155, 20156, 20157, 20158
  Modifié : 20115 (modification du jeu de caractères non valide pour les noms de bloc-notes)

Si vous gérez des erreurs associées à la validation de nom d’entité, ce changement peut être majeur. Le tableau suivant explique comment gérer les modifications.

Avril 2015

Lancement production de PATCH. Publication de la rubrique Mettre à jour le contenu d’une page.

Février 2015

Lancement en production des API suivantes :

• Requête de page

• Recherche de texte intégral

• Récupération du contenu de la page

• Créer des éléments ayant une position absolue

Publication des articles Code HTML d’entrée et de sortie pour les pages OneNote et Créer des pages avec des éléments ayant une position absolue et mise à jour de Obtenir le contenu et la structure OneNote. Publication des informations connexes sur le Blog des développeurs OneNote et la référence interactive de l’API OneNote.

Janvier 2015

Publication de l’exemple d’application Windows universelle sur GitHub. Lancement de l’API d’extraction d’URL de produit, d’URL de recette et de carte de visite, ainsi que du support d’option de chaîne de requête expand. Publication des articles Enrichir du contenu capturé et Extraire des objets dans la hiérarchie des blocs-notes.

Octobre 2014

Nous avons déplacé la documentation de référence vers notre nouvelle console API OneNote interactive.

Juillet 2014

Nous avons ajouté les pages de référence suivantes, qui correspondent à des fonctions supplémentaires :

• OneNote : verbe GET avec le chemin sections

• OneNote : verbe GET avec le chemin sections/id

• OneNote : verbe GET avec le chemin sectiongroups

• OneNote : verbe GET avec le chemin sectiongroups/id

• OneNote : verbe GET avec le chemin notebooks

• OneNote : verbe GET avec le chemin notebooks/id

• OneNote : verbe POST avec le chemin notebooks

• OneNote : verbe POST avec le chemin notebooks/id/sections

• Codes d’erreur et d’avertissement de l’API OneNote

Juin 2014

Format revisité pour la section Référence de l’API OneNote.

Semaine du 29 avril 2014, mise à jour mineure

Dans notre première mise à jour, nous avons mis en place quelques fonctionnalités très pratiques pour les développeurs qui créent des applications fonctionnant avec des documents PDF ou qui veulent placer des captures dans une section spécifique d’un bloc-notes :

• Affichage d’un document PDF sous forme d’images directement sur la page OneNote. Avec cette mise à jour, lorsque vous ajoutez un élément <img data-render-src="name:BlockOfPDFData"/>, l’API OneNote transforme les pages PDF en images, et les insère dans la page. La pratique courante consiste à intégrer le fichier PDF dans la page, ce qui est possible avec la balise <object data-render-src="name:BlockOfPDFData"/>. Vous pouvez même référencer le même élément BlockOfPDFData pour les deux balises. Avant cette mise à jour, vous pouviez intégrer le fichier à la page, mais ne pouviez pas créer d’images à partir de ces mêmes données PDF. Pour plus d’informations, consultez l’article Capturer et intégrer des fichiers PDF avec l’API OneNote.

• Création de pages dans des sections spécifiques en incluant le paramètre de requête sectionName dans vos requêtes de pages POST. Si le nom de section de niveau supérieur que vous indiquez n’existe pas, l’API le crée. Avec cette nouvelle fonctionnalité, votre application peut stocker des captures dans une section facilement reconnaissable. Pour en savoir plus, voir Capturer des pages dans une section spécifique à l’aide de l’API OneNote.

Les mises à jour suivantes ont été apportées à la documentation :

• Ajout de l’article Capturer et intégrer des fichiers PDF avec l’API OneNote, avec les informations de référence connexes.

• Ajout de l’article Capturer des pages dans une section spécifique à l’aide de l’API OneNote, avec les informations de référence connexes.

• Limites précisées, étant donné qu’elles lient les images et les fichiers incorporés dans l’article sur la prise en charge des balises HTML pour les pages et l’article Capturer des photos et des images avec l’API OneNote.

• Mise à jour de la page sur la prise en charge des balises HTML de l’API OneNote pour l’ajout de certaines balises prises en charge mais non documentées.

17 mars 2014, version initiale

Voici les principales caractéristiques de l’API OneNote actuellement :

• L’API version 1.0 est désormais disponible. Le principal point de terminaison REST est https://www.onenote.com/api/v1.0. Actuellement, /pages est le seul chemin d’accès aux ressources, mais nous en ajouterons d’autres prochainement.

• Dans cette version initiale, l’API prend en charge la création de pages OneNote en utilisant le langage HTML pour définir la page. Vous pouvez inclure des images et intégrer d’autres types de fichier binaire (jusqu’à 25 Mo par fichier, 75 Mo par page) sur chaque page OneNote. L’API peut prendre un instantané des pages web et l’inclure en tant qu’image sur la page OneNote. Elle effectue également une reconnaissance optique de caractères sur les images que votre application capture.

• Pour que votre application fonctionne, un identifiant client est requis ou un identifiant de package si vous développez une application Windows Store pour Windows 8. Vous trouverez toutes les informations nécessaires à la rubrique Obtenir un ID client à utiliser avec l’API OneNote.

• En outre, l’API OneNote exige que les utilisateurs de votre application disposent d’un compte Microsoft. En revanche, ils n’ont pas besoin d’utiliser un appareil Microsoft. Pour plus d’informations sur l’utilisation du kit de développement logiciel (SDK) Windows Live Connect, voir Authentification de l’utilisateur pour l’API OneNote.

Cette première partie de la documentation comprend les sections suivantes :

• Prise en main de l’API OneNote donne un bref aperçu de l’API et de sa simplicité d’utilisation. Cette section inclut également des didacticiels pour les principales plateformes ; ils vous aideront à démarrer.

• Développement avec l’API OneNote propose des extraits de code et des informations sur les tâches que vous aurez envie de réaliser lorsque vous utiliserez l’API.

• La console interactive Apigee.com vous permet d’utiliser l’API sur apigee.com.

Nous apprécions toujours un retour de votre part concernant les problèmes rencontrés dans la documentation et la pertinence de son contenu par rapport à vos besoins. L’API est conçue pour les développeurs d’applications novices et expérimentés, alors n’hésitez pas à nous dire ce que vous en avez pensé.