Table of contents
TOC
Réduire la table des matières
Développer la table des matières
Dernière mise à jour: 25/07/2018

Codes d’erreur et d’avertissement de OneNote API

S’applique aux : blocs-notes consommateur sur OneDrive | Blocs-notes Entreprise sur Office 365

Cet article décrit les codes d’erreur et d’avertissement qui sont renvoyés par OneNote API chaque fois qu’une requête envoyée via l’API échoue.

Réponses d’erreur et d’avertissement

Lorsque votre demande génère une erreur, l’API OneNote interrompt la demande et renvoie une réponse d’erreur sous forme d’objet JSON. Une réponse d’erreur contient le code d’erreur associé, un message et un lien vers la section appropriée de cet article. L’exemple suivant indique comment se présente une réponse d’erreur.

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

Lorsque votre requête génère un avertissement, l'API OneNote exécute la requête et inclut l'avertissement dans sa réponse. Une réponse peut contenir plusieurs avertissements, aussi l'API renvoie des avertissements sous forme d'un tableau d'objets JSON. Chaque avertissement contient un message et un lien vers la section appropriée de cet article. L'exemple suivant montre comment se présente une réponse d'avertissement dans le contexte d'une requête exécutée.

{
   "@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
      }
   ]
}

Une requête peut également générer à la fois une erreur et un ou plusieurs avertissements. Dans ce cas, l'API OneNote arrête l'exécution la requête et renvoie à la fois l'erreur et les avertissements. L'exemple suivant montre comment se présente une erreur contenant un avertissement.

{
   "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 vous devez travailler avec le support de Microsoft pour résoudre les problèmes, assurez-vous d'enregistrer l'en-tête X-CorrelationId et le timestamp de l'appel API.

Codes de 10001 à 19999

Le service rencontre des problèmes ou envoie des informations à l’application.

10001

Une erreur inattendue s’est produite et la requête a échoué.

10002

Le service n’est pas disponible actuellement.

10003

Le compte de l’utilisateur actuel a dépassé le nombre maximal de demandes actives. Votre application devra répéter la demande.

10004

Le service ne peut pas créer une page dans la section demandée, car celle-ci est protégée par un mot de passe.

10005

La requête dépasse le nombre maximal autorisé de balises d’image dans lesquelles l’attribut data-render-src contient un fichier PDF. Consultez l’article Ajouter des images et des fichiers.

10006

L’API OneNote n’a pas pu créer une page dans la section spécifiée, car celle-ci est endommagée.

10007

Le serveur est trop occupé pour traiter immédiatement la requête entrante.

10008

Une ou plusieurs des bibliothèques de documents sur l’instance OneDrive du groupe ou de l’utilisateur contient plus de 5 000 éléments OneNote (blocs-notes, sections, groupes de sections) et ne peuvent pas être interrogées à l’aide de l’API. Assurez-vous qu’aucune des bibliothèques de documents du groupe ou de l’utilisateur ne contient plus de 5 000 éléments OneNote. Consultez le blog de développement OneNote pour obtenir la procédure d’atténuation.

10012

Impossible de créer ou de mettre à jour l’entité, car la bibliothèque qui contient le bloc-notes nécessite que des éléments soient extraits pour pouvoir être modifiés. Pour en savoir plus, consultez l’article https://support.office.com/en-us/article/Configure-a-site-library-to-require-check-out-of-files-f63fcbdc-1db6-4eb7-a3eb-dd815500c9e7.

Supprimez la condition d’extraction de la bibliothèque ou déplacez le bloc-notes.

10013

Une ou plusieurs des bibliothèques de documents sur l’instance OneDrive du groupe ou de l’utilisateur contient plus de 20 000 éléments et ne peuvent pas être indexés pour effectuer une requête à l’aide de l’API. Assurez-vous qu’aucune des bibliothèques de documents du groupe ou de l’utilisateur ne contient plus de 20 000 éléments. Consultez le blog de développement OneNote pour obtenir la procédure d’atténuation.

19999

La requête a échoué en raison d’une erreur indéterminée.

Codes de 20001 à 29999

Le code de l’application a généré une erreur.

20001

La partie « Presentation » requise est manquante dans la requête. Une seule est requise. Consultez la référence OneNote API.

20002

La requête contient deux ou plusieurs parties « Presentation ». Une seule est requise. Consultez la référence OneNote API.

20003

Le type de contenu de la partie « Presentation » ne peut être qu'au format texte/html ou application/xhtml+xml. Consultez la référence OneNote API.

20004

Le code HTML de la partie « Presentation » contient une balise d’image pour laquelle les propriétés src et data-render-src sont définies. L’API ignorera la propriété src et utilisera la propriété data-render-src. Consultez la référence OneNote API.

20005

La requête d’URI est trop longue. La taille maximale de l’URI (y compris l’ensemble des paramètres et données) est de 16 ko ou 16 384 caractères.

20006

Le code HTML de la partie « Presentation » contient une balise d’image pour laquelle ni la propriété src ni la propriété data-render-src n’est définie. L’API ignorera la balise image. Consultez la référence OneNote API.

20007

Le code HTML de la partie « Presentation » contient une chaîne date/heure qui ne correspond à aucun format autorisé. Consultez la référence OneNote API.

20008

La taille de la requête est trop importante. Consultez la référence OneNote API.

20009

La requête contient des parties avec des noms en double. Les noms de parties doivent être uniques. ConsultezRéférence de l'API OneNote pour plus d'informations sur la façon de construire des requêtes en plusieurs parties.

20010

L’en-tête Content-Disposition n’a pas été fourni pour le type de contenu indiqué. ConsultezRéférence de l'API OneNote pour plus d'informations sur la façon de construire des requêtes en plusieurs parties.

20011

La requête contient une charge utile à plusieurs parties dont le format est incorrect. Les problèmes peuvent inclure notamment des lignes vides manquantes, une dernière ligne manquante, des séparateurs de partie dans un format incorrect. Si vous créez le message en plusieurs parties à la main, vérifiez soigneusement la logique ou envisagez d’utiliser une bibliothèque tierce. Consultez Référence de l'API OneNote pour plus d'informations sur la façon de construire une charge utile en plusieurs parties.

20012

La requête ne fournit aucun type de contenu pour la partie indiquée. Consultez Référence de l'API OneNote pour plus d'informations sur la façon de construire une partie.

20013

La requête ne fournit pas les en-têtes Content-Type et Content-Disposition pour la partie spécifiée.

20014

La longueur d’une partie du message en plusieurs parties dépasse la taille maximale de 25 Mo. Consultez la référence OneNote API.

20015

Le nombre de parties du message en plusieurs parties dépasse le nombre maximal fixé à 500. Consultez la référence OneNote API.

20016

La longueur du message en plusieurs parties dépasse la limite fixée à 75 Mo. Consultez la référence OneNote API.

20100

La syntaxe de votre requête n’est pas correcte. Consultez Référence OneNote API pour en savoir plus et assurez-vous d'avoir correctement construit votre requête.

20101

La propriété que vous avez demandée n’existe pas.

20102

Vous avez demandé une ressource qui n’existe pas.

20103

La requête expand n’est pas prise en charge pour cette requête. Reportez-vous à la section Options de chaîne de requête OData prises en charge.

20104

L’option de requête pagelevel est uniquement prise en charge lorsque vous souhaitez obtenir la collection de pages d’une section ou la collection correspondant à une page spécifique. Par exemple :

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

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

20106

Votre requête contient un opérateur de requête non pris en charge. Consultez la référence OneNote API.

20108

Votre requête contient des paramètres de requête OData non pris en charge.

20109

La charge utile de la requête PATCH n’est pas correctement construite.

20110

Les demandes de création de page contenant des parties de données nécessitent que le contenu soit en plusieurs parties, avec une partie « Presentation ». Consultez la référence OneNote API.

20111

Votre requête utilise une fonctionnalité OData non prise en charge.

20112

Votre requête contient un identifiant non valide pour le bloc-notes cible, un groupe de sections, une section ou une entité de page.

20113

La ressource spécifiée dans la requête a été supprimée.

20115

Le nom contient des caractères non valides. Un nom de bloc-notes ne peut pas contenir les caractères suivants : ? * \ / : < > | ' "

20117

Un élément portant le nom indiqué existe déjà à l’emplacement spécifié.

20119

Le code HTML de la partie « Presentation » contient un attribut data-attachment au format incorrect ou qui inclut au moins un de ces caractères non valides pour un nom de fichier : \ / : * ? < > | ". La requête a remplacé la valeur indiquée dans le message d’erreur.

20120

Votre requête spécifie une cible PATCH qui ne peut pas être localisée.

20121

Votre requête contient un argument PATCH non valide. Voir Mise à jour du contenu de la page.

20122

Votre requête spécifie une action PATCH non prise en charge. Voir Mise à jour du contenu de la page.

20123

La requête PATCH ne peut pas modifier la page spécifiée.

20124

Votre requête PATCH en plusieurs parties ne contient aucune partie « commandes » avec la structure JSON d’action PATCH. Reportez-vous à l’article Mettre à jour le contenu de la page

20125

Votre requête PATCH ne contient aucune action. Voir Mise à jour du contenu de la page.

20126

Le corps du message contient des données JSON au format incorrect ou des champs non pris en charge pour cette opération.

20127

Votre requête spécifie le nom d’une propriété inconnue.

20128

Votre requête contient une erreur de syntaxe OData à la position indiquée dans le message.

20129

Votre requête comporte une option de chaîne de requête top dont la valeur est trop élevée. Pour les requêtes de page, la valeur maximale est de 100 et la valeur par défaut de 20.

20130

Votre requête contient un URI qui pointe vers une ressource HTTP introuvable.

20131

Votre requête contient une valeur incorrecte pour l’en-tête Content-Type. Utilisez la valeur indiquée dans le message. Consultez la référence OneNote API.

20132

Votre requête comporte du contenu non valide. Ce problème peut provenir d’un en-tête de requête Content-Type manquant et/ou de l’absence de contenu dans le corps de la demande. Consultez la référence OneNote API.

20133

Votre requête indique une cible PATCH non prise en charge. Reportez-vous à l’article Mettre à jour le contenu de la page

20134

Votre requête spécifie un élément non valide comme cible de l’action PATCH. Si la cible utilise l’identificateur data-id, vérifiez qu’il a un symbole # comme préfixe. Voir Mise à jour du contenu de la page.

20135

Votre requête spécifie un type d’entité non pris en charge pour l’opération PATCH. Reportez-vous à l’article Mettre à jour le contenu de la page

20136

Votre requête contient un attribut data-render-src or data-render-method non valide ou manquant. Reportez-vous à l’article Extraire les données de captures.

20137

La page cible ne prend pas en charge les requêtes PATCH.

20138

Le type d’élément cible dans votre requête PATCH ne prend pas en charge l’action append. Voir Mise à jour du contenu de la page.

20139

Votre requête contient une valeur d’attribut data-tag non valide. Voir Use note tags.

20140

Votre requête contient une valeur de statut data-tag non valide. Les balises de note de case à cocher peuvent avoir le statut terminé. Exemple :

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

Reportez-vous à l’article Utiliser des balises de notes.

20141

La cible dans votre requête PATCH ne prend pas en charge l’action spécifiée. Reportez-vous à l’article Mettre à jour le contenu de la page

20142

Votre requête contient une expression expand pour un parent d’entités enfants ou un enfant d’entités parentes, ce qui n’est pas pris en charge. Reportez-vous à la section Options de chaîne de requête OData prises en charge.

20143

La requête OData n’est pas valide.

20144

Votre requête contient une expression expand pour une propriété autre que de navigation. Seules les propriétés de navigation peuvent être développées.

20145

L’expression select ou expand de votre requête contient un terme non valide.

20146

L’attribut style="position:absolute" est spécifié sur un élément, mais l’élément body ne spécifie pas data-absolute-enabled="true", qui est nécessaire pour prendre en charge le positionnement. Tous les paramètres de position seront ignorés. Reportez-vous à l’article Créer des éléments ayant une position absolue

20147

L’attribut style="position:absolute" est spécifié sur un élément qui n’est pas un enfant direct de l’élément body, qui n’est pas pris en charge. Si l’élément est un élément div, img ou object, définissez-le comme enfant direct de l’élément body. Dans le cas contraire, les paramètres de position seront ignorés et son contenu s’affichera à l’intérieur d’une balise div ayant une position absolue. Reportez-vous à l’article Créer des éléments ayant une position absolue

20148

L’attribut style="position:absolute" est spécifié sur un type d’élément qui ne le prend pas en charge. Seuls les éléments div, img et object qui sont des enfants directs du corps de la page prennent en charge le positionnement. Reportez-vous à l’article Créer des éléments ayant une position absolue

20149

Votre requête spécifie un élément cible introuvable.

20150

La demande n’est pas valide pour ce type d’authentification. Utilisez le chemin d’accès ../me/notes/ à la place.

20151

La demande n’est pas valide pour ce type d’authentification. Utilisez le point de terminaison ../me/notes/section/{id}/pages pour créer une page dans une section spécifique.

20152

Aucune valeur name n’est spécifiée pour l’entité. Le nom doit être défini et ne peut pas contenir que des espaces blancs.

20153

Le nom de l’entité contient des caractères non valides. Un nom ne peut pas contenir les caractères suivants : ? * \ / : < > | & # " % ~

20154

Le nom de l’entité ne peut pas commencer par un espace.

20155

Le nom de l’entité est trop long. Les noms de bloc-notes ont une limite maximale de 128 caractères. Les autres noms d’entité ont une limite de 50 caractères.

20156

L’ID spécifié pour la ressource de destination n’existe pas.

20157

L’ID spécifié pour l’entité de destination n’est pas valide.

20158

Impossible d’obtenir des métadonnées pour l’URL du site spécifiée dans la demande. Vérifiez le format de l’URL fournie. Les formats pris en charge incluent https://domain.sharepoint.com/site-a et https://domain.com/sites/site-a.

20160

Impossible de trouver un groupe Office 365 ayant l’ID spécifié.

20161

Le contexte n’indique aucun identifiant utilisateur valide. La transmission d’un PUID/CID sous une forme longue et non hexadécimale est une erreur courante.

20166

L’application a émis trop de demandes au nom d’un utilisateur sur une courte période. Pour s’assurer que l’API OneNote reste stable et réactive, l’API renvoie un code d’état 429 avec cette erreur lorsqu’elle détecte qu’une application utilise trop de ressources. Pour plus d’informations, consultez l’article Quelles limitations pour l’API OneNote et comment les contourner.

20168

La vidéo source indiquée dans la demande n’est pas prise en charge. Consultez l’article Sites vidéo pris en charge pour obtenir la liste actuelle.

Codes de 30001 à 39999

Un problème est survenu avec le compte d’utilisateur.

30101

Le compte d’utilisateur a dépassé son quota OneDrive. Consultez l’article OneDrive.

30102

Aucun autre élément ne peut être ajouté à la section demandée car la taille maximale a été atteinte.

30103

L’utilisation des ressources est trop élevée pour la demande. Le compte d’utilisateur cible possède un grand jeu de données ou le service reçoit un nombre élevé de demandes simultanées sur le même site (par exemple, un site personnel de l’utilisateur ou un site d’équipe).

30104

Le compte d’utilisateur a été suspendu.

30105

Le site OneDrive Entreprise personnel de l’utilisateur n’est pas approvisionné, ce qui est nécessaire pour accéder aux blocs-notes. Le service OneNote va à présent approvisionner le site. Ce processus peut prendre plusieurs minutes.

30106

OneDrive Entreprise est en cours d’approvisionnement pour l’utilisateur.

30108

L’instance OneDrive Entreprise personnelle de l’utilisateur n’a pas pu être récupérée. Voici quelques causes possibles.

CauseRésolution
Le site personnel de l’utilisateur n’a pas été approvisionné.L’utilisateur doit ouvrir OneDrive Entreprise et suivre les instructions pour approvisionner le site. En cas d’échec, l’utilisateur doit contacter l’administrateur client d’Office 365.
Le site personnel de l’utilisateur est actuellement en cours d’approvisionnement.Renouvelez la demande ultérieurement.
L’utilisateur ne dispose pas d’une licence OneDrive Entreprise valide.L’utilisateur doit contacter l’administrateur client d’Office 365.
Un problème de réseau a empêché l’envoi de la demande.Renouvelez la demande ultérieurement.

Codes de 40001 à 49999

L’utilisateur ou l’application ne dispose pas des autorisations correctes.

40001

La demande ne contient aucun jeton OAuth valide. Consultez Authentification OneNote et autorisations.

40002

L’utilisateur n’est pas autorisé à écrire à l’emplacement demandé.

40003

L’utilisateur n’est pas autorisé à accéder à la ressource demandée.

40004

Le jeton OAuth ne dispose pas des étendues nécessaires pour effectuer l’action demandée. Consultez Authentification OneNote et autorisations.

En-tête X-CorrelationId

Outre les codes de réponse HTTP standard, OneNote API renvoie des en-têtes à l'application appelante. Sont inclus dans chaque réponse une en-tête X-CorrelationId et un en-tête Date comme illustré dans l'extrait suivant :

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

L’ID de corrélation est un GUID qui rassemble les divers éléments dans les serveurs principaux. Les ID de corrélation ne sont pas séquentiels, ce qui signifie que vous ne pouvez pas les utiliser pour établir un ordre de création des pages.

Votre application peut enregistrer l'ID de corrélation et la date de vos appels d'API. Vous pouvez utiliser ces valeurs si vous devez travailler avec l'assistance Microsoft pour résoudre les problèmes de votre application ou avec l'API.

Ressources supplémentaires

© 2018 Microsoft