FAQ sur la récupération des liens de ressources
La récupération de contenu à partir d’un espace différent fonctionne-t-elle de la même manière que la récupération de contenu à partir du même espace ?
Non, la résolution d’entités liées provenant d’espaces différents nécessite qu’un en-tête spécial soit transmis dans chaque requête, nommé x-contentful-resource-resolution.
À partir de combien d’espaces différents puis-je récupérer du contenu ?
Seuls 3 jetons d’espace supplémentaires sont pris en charge. Cela signifie que vous pouvez effectuer un seul appel d’API qui résout jusqu’à 4 espaces en même temps : 3 espaces supplémentaires et le spaceId de la demande initiale.
Jusqu’à combien de niveaux peut-on aller pour récupérer du contenu provenant d’autres espaces ?
Il est possible d’obtenir jusqu’à 1 niveau de contenu provenant d’autres espaces.
Dois-je fournir des jetons d’authentification pour les espaces à partir desquels je récupérerai du contenu ?
Oui, vous devez fournir des jetons dans le nouvel en-tête pour les espaces à partir desquels vous récupérerez du contenu. Il faut convertir l’élément en chaîne de texte puis l’encoder en base64. La chaîne obtenue peut ensuite être utilisée comme un jeton unique.
Que se passe-t-il si je fournis un ou des jetons incorrects pour les espaces à partir desquels je souhaite récupérer du contenu ?
Une erreur sera renvoyée dans la propriété errors de la réponse et ce spaceId ne sera pas résolu.
Que se passe-t-il si je fournis plus de 3 jetons dans l’en-tête ?
Une erreur sera générée si vous fournissez plus de 3 jetons.
Où puis-je voir le contenu résolu provenant d’autres espaces dans la charge utile ?
La propriété includes dans la charge utile contiendra l’entrée provenant d’un autre espace.
Que se passe-t-il si la récupération d’un lien depuis un autre espace ne fonctionne pas ?
L’appel de l’API échouera partiellement. Par exemple, l’entrée sera renvoyée avec succès, mais la récupération du lien ayant échoué ne sera pas incluse dans la propriété includes de la charge utile. Les récupérations de liens réussies seront renvoyées dans la charge utile.
Puis-je récupérer des éléments liés dans le même espace ainsi que des éléments liés provenant d’espaces différents dans le même appel d’API ?
Oui. Le contenu que vous récupérez peut contenir des liens internes à l’espace ou vers d’autres espaces. Dans ce cas, il reste possible de récupérer du contenu jusqu’à 10 niveaux pour les liens internes à un même espace.
Que se passe-t-il si le lien récupéré dans le même espace contient des références vers d’autres espaces ? Seront-ils résolus ?
Oui, si le contenu lié que vous avez récupéré dans le même espace contient des liens vers différents espaces, ceux-ci peuvent également être résolus dans le respect de la limitation de 4 (3+1) espaces différents (distincts) dans la même requête.
Que se passe-t-il si le lien récupéré à partir d’un autre espace contient des liens dans le même espace ? Seront-ils résolus ?
Oui, si le contenu lié récupéré à partir de différents espaces contient des liens dans l’espace, ceux-ci peuvent également être résolus jusqu’à 1 niveau.
Est-ce que récupérer des liens entre plusieurs espaces utilise le quota de requêtes de chacun de ces espaces ?
Quand vous résolvez des liens entre espaces, le quota de requêtes de chaque espace concerné est utilisé. Ainsi, il se peut que les entrées inter-espaces ne soient pas complètement résolues si un espace devant être résolu a déjà dépassé son quota de requêtes.
Cependant, cela n’est valable que pour les requêtes non mises en cache. Lorsque vos appels API sont servis à partir de requêtes mises en cache, le quota de requêtes n’est pas utilisé.