Skip to content

Listar Content Blocks disponíveis

get

/content_blocks/list

Use esse endpoint para listar as informações dos seus Content Blocks existentes.

See me in Postman

Pré-requisitos

Para usar esse endpoint, você precisará de uma chave de API com a permissão content_blocks.list.

Limite de taxa

Aplicamos o limite de taxa padrão da Braze de 250.000 solicitações por hora a esse endpoint, conforme documentado em Limites de taxa da API.

Parâmetros de solicitação

Parâmetro Obrigatória Tipo de dados Descrição
modified_after Opcional String no formato ISO-8601 Recupera apenas Content Blocks atualizados no momento ou após o momento especificado.
modified_before Opcional String no formato ISO-8601 Recupera apenas Content Blocks atualizados antes ou no momento especificado.
limit Opcional Número positivo Número máximo de Content Blocks a serem recuperados. O padrão é 100 se não for fornecido, com um valor máximo aceitável de 1000.
offset Opcional Número positivo Número de Content Blocks a serem ignorados antes de retornar o restante dos modelos que atendem aos critérios de pesquisa.

Exemplo de solicitação

1
2

curl --location --request GET 'https://rest.iad-01.braze.com/content_blocks/list?modified_after=2020-01-01T01:01:01.000000&modified_before=2020-02-01T01:01:01.000000&limit=100&offset=1' \
--header 'Authorization: Bearer YOUR-API-KEY-HERE'

Resposta

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

{
  "count": "integer",
  "content_blocks": [
    {
      "content_block_id": (string) the Content Block identifier,
      "name": (string) the name of the Content Block,
      "content_type": (string) the content type, html or text,
      "liquid_tag": (string) the Liquid tags,
      "inclusion_count" : (integer) the inclusion count,
      "created_at": (string) The time the Content Block was created in ISO 8601,
      "last_edited": (string) The time the Content Block was last edited in ISO 8601,
      "tags": (array) An array of tags formatted as strings
    }
  ]
}

Solução de problemas

A tabela a seguir lista os possíveis erros retornados e as etapas de solução de problemas associadas.

Erro Solução de problemas
Modified after time is invalid A data fornecida não é uma data válida ou analisável. Reformate esse valor como uma string no formato ISO 8601 (yyyy-mm-ddThh:mm:ss.ffffff).
Modified before time is invalid A data fornecida não é uma data válida ou analisável. Reformate esse valor como uma string no formato ISO 8601 (yyyy-mm-ddThh:mm:ss.ffffff).
Modified after time must be earlier than or the same as modified before time. Altere o valor de modified_after para um horário anterior ao horário de modified_before.
Content Block number limit is invalid O parâmetro limit precisa ser um número inteiro (número positivo) maior que 0.
Content Block number limit must be greater than 0 Altere o parâmetro limit para um número inteiro maior que 0.
Content Block number limit exceeds maximum of 1000 Altere o parâmetro limit para um número inteiro menor que 1000.
Offset is invalid O parâmetro offset deve ser um número inteiro maior que 0.
Offset must be greater than 0 Altere o parâmetro offset para um número inteiro maior que 0.
New Stuff!