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 | nom | 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 d'une manière ou d'une autre. |
| 401 | Non autorisé | L'API n'a pas pu trouver d'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 | Non trouvé | Les ressources demandées ne peuvent pas être trouvées. |
| 429 | Trop de demandes | La demande n'a pas été traitée car une limite de débit a été atteinte. |
| 5xx | Erreur interne 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. Il peut les accepter en se connectant à l'App Store sur un appareil iOS ou macOS avec son compte, ou en se rendant 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-web-access-required
L'accès aux données iCloud sur le Web est désactivé pour le compte. Consultez l'article d'assistance Apple pour l'activer.
icloud-adp-enabled
La protection avancée des données est activée pour le compte iCloud, mais elle n'est pas prise en charge par l'API. Consultez l'article d'assistance Apple pour savoir comment la désactiver.
icloud-signin-rate-limited
L'accès au compte iCloud est limité par Apple, généralement en raison de trop nombreuses tentatives infructueuses d'initialisation de session. Veuillez réessayer ultérieurement.
icloud-account-locked
L'accès au compte iCloud a été bloqué par Apple, généralement pour des raisons de sécurité. Contactez l'assistance Apple pour en savoir plus sur le déverrouillage du compte.
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.