Erreurs

Mis à jour
Cover image for: Erreurs

L'API renvoie les codes d'état de réussite ou d'erreur HTTP standard pour toutes les opérations. Pour les erreurs, la réponse comprendra le code d'erreur correspondant, un court message décrivant la cause de l'erreur et éventuellement des champs supplémentaires transmettant des informations spécifiques à cette erreur.

Codes d'état

code prénom la description
200 D'accord La demande a été traitée avec succès.
201 créé La demande a été traitée avec succès et une nouvelle instance de ressource a été créée.
400 Mauvaise Demande L'API n'a pas pu traiter la demande car elle était malformée.
401 non autorisé L'API n'a pas pu trouver des informations d'identification valides dans la demande.
403 interdit Les informations d'identification fournies ne disposent pas des autorisations suffisantes pour exécuter la demande.
404 pas trouvé Les ressources demandées sont introuvables.
429 trop de demandes La demande n'a pas été traitée car une limite de débit a été atteinte.
5xx erreur du serveur Une erreur inattendue s'est produite lors du traitement de l'événement.

Codes d'erreur

invalid-body

L'API n'a pas pu traiter le corps de votre demande. Assurez-vous que le corps de la demande est un JSON valide.

invalid-parameter

Un ou plusieurs paramètres de votre requête n'ont pas passé les contrôles de validation. Cette réponse comprendra un attribut params avec plus de détails sur les paramètres incriminés.

unconfigured

Votre organisation ne dispose pas de la configuration requise pour que l'API puisse traiter cette demande. Le message inclura des détails sur la configuration manquante.

missing-scope

Votre organisation, votre clé ou l'utilisateur actuel ne dispose pas des étendues d'autorisation requises pour exécuter cette demande.

limit-exceeded

La demande n'a pas pu être traitée car elle violerait une limite imposée à votre organisation, à votre clé ou à votre utilisateur actuel. Par exemple, un utilisateur limité à deux comptes iCloud par mois recevra cette erreur s'il tente d'accéder à un troisième compte.

session-expired

La session que vous essayez d'utiliser pour cette demande a été marquée comme expirée par l'API. Vous devez créer une nouvelle session valide avant de continuer.

invalid-credentials

Les informations d'identification fournies ont été rejetées par le service externe. Soit la source n’existe pas (c’est-à-dire un nom d’utilisateur non valide), soit le contenu des informations d’identité est incorrect (par exemple, un mot de passe erroné).

source-locked

La source a été verrouillée par le service externe et l'API ne peut y accéder que lorsqu'elle est déverrouillée par l'utilisateur. Le message de l'API fournira des instructions sur la procédure à suivre pour le service concerné.

code-required

La source sur laquelle vous essayez de créer une session est activée par l’authentification multi-facteurs (MFA). L'API aura déclenché le processus MFA et vous devez fournir le code présenté lors de ce processus lors de votre prochaine tentative de création de session.

Pour plus de détails sur le flux de création de session, voir la référence de service pour le service auquel vous essayez d'accéder.

code-rate-limited

L'utilisateur a tenté de créer une session en utilisant un code invalide trop souvent et a été limité par le service. Nous recommandons à l'utilisateur d'attendre au moins une heure avant de réessayer.

choice-required

La vérification à deux étapes (2SV) est activée, un sous-ensemble de l'authentification multi-facteurs (MFA). Dans le cadre de cette réponse, l’API fournira une liste de périphériques contre lesquels le processus 2SV peut être déclenché; cet appareil recevra le code 2SV qui sera nécessaire pour la prochaine étape du processus.

Pour plus de détails sur le flux de création de session, voir la référence de service pour le service auquel vous essayez d'accéder.

task-error

Une erreur de tâche générique s'est produite. Une nouvelle tentative de sondage ou de tâche peut résoudre le problème. Veuillez contacter le support si le problème persiste.

Codes d'erreur du service iCloud

icloud-terms-not-accepted

L'utilisateur n'a pas accepté les dernières conditions d'utilisation d'iCloud. Ils peuvent accepter les conditions en se connectant à l'App Store sur un appareil iOS ou macOS en utilisant leur compte, ou en allant sur iCloud.com .

icloud-account-not-verified

L'adresse e-mail principale associée au compte iCloud n'a pas encore été vérifiée. L'utilisateur doit terminer le processus de vérification des e-mails pour activer le compte. Le processus de vérification peut être géré en vous connectant à appleid.apple.com .

icloud-service-not-activated

Le service iCloud nécessaire pour terminer l'opération n'a pas été activé sur le compte iCloud utilisé. Par exemple, si l'utilisateur n'a pas activé la bibliothèque de photos iCloud sur le compte, cette erreur sera icpl.photos lors de la tentative de récupération d' icpl.photos .

Assurez-vous que l'utilisateur a basculé sur les paramètres associés à un service pour s'assurer qu'il est activé.

icloud-service-outage

L'opération n'a pas pu être terminée en raison d'une panne iCloud. Ce sont très rares et généralement transitoires - une nouvelle tentative en quelques minutes devrait réussir. Cependant, si le problème persiste, recherchez plus d'informations sur la page d'état iCloud et la page d'état API et contactez l'assistance.

Comment pouvons nous aider?

Notre équipe de support est là pour vous aider!

Nos bureaux sont ouverts du lundi au vendredi, de 9 h à 17 h GMT. L’heure est actuellement 5:00 Matin GMT.

Notre objectif est de répondre à tous les messages en un jour ouvrable.

Aller à la section support › Contacter l'équipe de l'entreprise ›
Notre superbe équipe de support

Pouvons-nous améliorer cet article?

Nous aimons entendre les utilisateurs: pourquoi ne pas nous envoyer un email, laisser un commentaire ou tweet @reincubate?

© 2008 - 2020 Reincubate Ltd. Tous droits réservés. Enregistré en Angleterre et au Pays de Galles #5189175, VAT GB151788978. Reincubate et Camo sont des marques déposées. Politique de confidentialité & termes. Nous recommandons l'authentification multi-facteurs. Construit avec à Londres.