Vai al contenuto principale

Ottieni un elenco di tutti i modelli

L'endpoint viene utilizzato per ottenere un elenco di tutti i modelli di sistema inclusi i modelli Video, Carousel, Immagine, Citazioni e Meme. Questo è un endpoint impaginato e quindi riceverai una risposta impaginata.

URL richiesta

  • GET https://brain.predis.ai/predis_api/v1/get_templates/

Richiedi parametri

NomeDescrizioneTipoValore di defaultPossibili valoriObbligatorio
brand_idIl brand_id funge da identificatore univoco per il tuo marchio. Utilizzando brand_id, avrai anche accesso ai tuoi modelli personalizzati nella prima pagina.CordaNoneYOUR_BRAND_IDSi
media_typePer ottenere modelli di un tipo di supporto specifico.Cordasingle_imagesingle_image, carousel, videoNon
post_typePer ottenere modelli di una specifica tipologia di post. Per meme and quotes settimana media_type dovrebbe essere single_image.Cordagenericgeneric, meme, quotesNon
aspect_ratioPer ottenere modelli con proporzioni specifiche.Cordaallsquare, portrait, landscape, allNon
page_nIndicare il numero di pagina per recuperare i modelli da quella particolare pagina.Numero intero11, 2, 3...etcNon
items_nIndicare il numero desiderato di modelli per ogni pagina.Numero intero101, 2, 3...etcNon

Esempio di risposta positiva

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

Esempio di risposta all'errore

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

Codici di risposta

HTTP Status CodeCodice di erroreMessaggio utenteSoluzione consigliata
429001Numero massimo di richieste raggiuntoNumero massimo di richieste orarie raggiunto Hai ricevuto un limite di velocità. Attendi un po' e riprova
400002invalido brand_id purchéHai fornito un invalido brand_id. Si prega di fornire un valido brand_id e riprovare. Per saperne di più Qui.
400003I numeri di pagina del numero di articoli non sono validiAssicurati del valore di page_n and items_n è intero
400004Fornito aspect_ratio non è supportatoAssicurati del valore di aspect_ratio il campo è supportato. Per ulteriori dettagli, controlla i parametri della richiesta nella tabella sopra
400005Il valore fornito per il file media_type il campo non è validoAssicurati che il valore sia uno di single_image, carousel or video
400006Il valore fornito per il file video_duration il campo non è validoAssicurati che il valore sia uno dei due short or long
400007Il valore fornito per il file post_type il campo non è validoAssicurati che il valore sia uno dei due generic, meme or quotes
400008Il valore fornito per il file post_type il campo non è valido per il dato media_typeIl fornito post_type and media_type la combinazione di post non è ancora supportata. Per ulteriori dettagli, controlla i parametri della richiesta nella tabella sopra

rate limiting

Standard API i limiti di velocità si applicano a questo endpoint. Ulteriori informazioni sui limiti di tariffa Qui.