Passer au contenu principal

Obtenez une liste de tous les modèles

Le point de terminaison est utilisé pour obtenir une liste de tous les modèles système, y compris les modèles vidéo, carrousel, image, citations et mèmes. Il s'agit d'un point de terminaison paginé et vous recevrez donc une réponse paginée.

Demander une URL

  • ÉCONOMISEZ https://brain.predis.ai/predis_api/v1/get_templates/

Paramètres de demande

NomDescriptionTypeValeur par défautValeurs possiblesRequis
brand_idLe brand_id sert d’identifiant unique pour votre marque. Grâce au brand_id, vous aurez également accès à vos modèles personnalisés sur la première page.ChaîneNoneYOUR_BRAND_IDOui
media_typePour obtenir des modèles d’un type de média spécifique.Chaînesingle_imagesingle_image, carousel, videoNon
post_typePour obtenir des modèles d’un type de message spécifique. Pour meme et quotes media_type devrait être single_image.Chaînegenericgeneric, meme, quotesNon
aspect_ratioPour obtenir des modèles d’un rapport hauteur/largeur spécifique.Chaîneallsquare, portrait, landscape, allNon
page_nIndiquez le numéro de page pour récupérer les modèles de cette page particulière.Entier11, 2, 3...etcNon
items_nIndiquez le nombre de modèles souhaité pour chaque page.Entier101, 2, 3...etcNon

Exemple de réponse réussie

{
"templates": [{
"template_id": "...",
"media_type": "..."
}],
"total_pages": 50,
"errors": []
}

Exemple de réponse à une erreur

{
"errors": [{
"detail": "...",
"solution": "..."
}]
}

Codes de réponse

Code d'état HTTPCode d'erreurMessage de l'utilisateurSolution recommandée
429001Nombre maximum de demandes atteintNombre maximal de requêtes horaires atteint Votre débit a été limité. Veuillez patienter quelques instants et réessayer
400002Invalide brand_id à condition deVous avez fourni un invalide brand_id. Veuillez fournir un brand_id et réessayez. En savoir plus ici
400003Les numéros de page du numéro d'article ne sont pas validesAssurez-vous que la valeur de page_n et items_n est un entier
400004À condition de aspect_ratio est pas supportéAssurez-vous que la valeur de aspect_ratio Le champ est pris en charge. Veuillez vérifier les paramètres de demande dans le tableau ci-dessus pour plus de détails.
400005La valeur fournie pour le media_type le champ n'est pas valideAssurez-vous que la valeur est l'une des single_image, carousel or video
400006La valeur fournie pour le video_duration le champ n'est pas valideAssurez-vous que la valeur est soit short or long
400007La valeur fournie pour le post_type le champ n'est pas valideAssurez-vous que la valeur est soit generic, meme or quotes
400008La valeur fournie pour le post_type le champ n'est pas valide pour le donné media_typeLe fourni post_type et media_type la combinaison de messages n'est pas encore prise en charge. Veuillez vérifier les paramètres de demande dans le tableau ci-dessus pour plus de détails.

Limitation du débit

Standard API des limites de débit s’appliquent à ce point de terminaison. En savoir plus sur les limites de taux ici