Por meio da API do Content Delivery você pode consultar, criar, remover ou atualizar suas configurações. Para gerenciamento de Error Responses, utilize os endpoints que seguem.

  1. Consultar lista de Error Responses
  2. Sobrescrever lista de Error Responses
  3. Atualizar um campo de Error Responses

1. Consultar lista de Error Responses

Retorna a lista de Error Responses de uma configuração de Content Delivery e seus respectivos tempos de cache em segundos.

GET /content_delivery/configurations/:conf_id/error_responses

Permissão necessária: View Content Delivery

Parâmetro Descrição Tipo de Parâmetro Tipo de Dado
Authorization

(obrigatório)

A autenticação por Token previamente criado através do endpoint de Criação de Token.

ex.:

Authorization: Token 583f8a9ca8d6d5ff2cb50f1d3c4d35cb8939f1bf

header string
:conf_id

(obrigatório)

 Id da configuração de Content Delivery a ser consultada.
Para obter o Id de uma configuração, consulte a Lista de Configurações.
 path  number

Exemplo de Requisição

Exemplo de Resposta


2. Sobrescrever lista de Error Responses

Sobrescreve todos os tempos de cache de Error Responses. Considere utilizar o método PATCH no lugar de PUT, para atualizar somente alguns campos da configuração sem alterar o valor dos demais.

PUT /content_delivery/configurations/:conf_id/error_responses

Permissão necessária: Edit Content Delivery

Parâmetro Descrição Tipo de Parâmetro Tipo de Dado
Authorization

(obrigatório)

A autenticação por Token previamente criado através do endpoint de Criação de Token.

ex.:

Authorization: Token 583f8a9ca8d6d5ff2cb50f1d3c4d35cb8939f1bf

header string
Content-Type

(obrigatório)

O tipo de codificação utilizada no Body (application/json).

ex.:

Content-Type: application/json

header string
:conf_id

(obrigatório)

Id da configuração de Content Delivery para a qual a Origem deve ser substituída.
Para obter o Id de uma configuração, consulte a Lista de Configurações.
path number
Error Responses

(obrigatório)

A lista de tempos de cache (em segundos) para Error Responses deve ser enviada codificada no formato json, com os seguintes campos:

  • cache_error_400 (number): tempo de cache na CDN para o código de erro 400 Bad Request.
  • cache_error_403 (number): tempo de cache na CDN para o código de erro 403 Forbidden.
  • cache_error_404 (number): tempo de cache na CDN para o código de erro 404 Not Found.
  • cache_error_405 (number): tempo de cache na CDN para o código de erro 405 Method Not Allowed.
  • cache_error_414 (number): tempo de cache na CDN para o código de erro 414 URI Too Long.
  • cache_error_416 (number): tempo de cache na CDN para o código de erro 416 Range Not Satisfiable.
  • cache_error_501 (number): tempo de cache na CDN para o código de erro 501 Not Implemented.
body json

Exemplo de Requisição

1
2
3
4
5
6
7
8
9
10
{
   "cache_error_400": 0,
   "cache_error_403": 0,
   "cache_error_404": 300,
   "cache_error_405": 30,
   "cache_error_414": 30,
   "cache_error_416": 30,
   "cache_error_501": 30
}
 

Exemplo de Resposta

1
2
3
4
5
6
7
8
9
10
{
   "cache_error_400": 0,
   "cache_error_403": 0,
   "cache_error_404": 300,
   "cache_error_405": 30,
   "cache_error_414": 30,
   "cache_error_416": 30,
   "cache_error_501": 30
}
 


3. Atualizar um campo de Error Responses

Atualiza um ou mais campos da lista de tempos de cache para Error Responses em uma configuração de Content Delivery, preservando o valor dos campos não informados.

PATCH /content_delivery/configurations/:conf_id/error_responses

Permissão necessária: Edit Content Delivery

Parâmetro Descrição Tipo de Parâmetro Tipo de Dado
Authorization

(obrigatório)

A autenticação por Token previamente criado através do endpoint de Criação de Token.

ex.:

Authorization: Token 583f8a9ca8d6d5ff2cb50f1d3c4d35cb8939f1bf

header string
Content-Type

(obrigatório)

O tipo de codificação utilizada no Body (application/json).

ex.:

Content-Type: application/json

header string
:conf_id

(obrigatório)

Id da configuração de Content Delivery para a qual a origem deve ser atualizada.
Para obter o Id de uma configuração, consulte a Lista de Configurações.
path number
Error Responses

(obrigatório)

A lista de tempos de cache (em segundos) para Error Responses, que se deseja atualizar, deve ser enviada codificada no formato json:

  • cache_error_400 (number): tempo de cache na CDN para o código de erro 400 Bad Request.
  • cache_error_403 (number): tempo de cache na CDN para o código de erro 403 Forbidden.
  • cache_error_404 (number): tempo de cache na CDN para o código de erro 404 Not Found.
  • cache_error_405 (number): tempo de cache na CDN para o código de erro 405 Method Not Allowed.
  • cache_error_414 (number): tempo de cache na CDN para o código de erro 414 URI Too Long.
  • cache_error_416 (number): tempo de cache na CDN para o código de erro 416 Range Not Satisfiable.
  • cache_error_501 (number): tempo de cache na CDN para o código de erro 501 Not Implemented.
body json

Exemplo de Requisição

1
2
3
4
{
   "cache_error_404": 30
}
 

Exemplo de Resposta

1
2
3
4
5
6
7
8
9
10
{
   "cache_error_400": 0,
   "cache_error_403": 0,
   "cache_error_404": 30,
   "cache_error_405": 30,
   "cache_error_414": 30,
   "cache_error_416": 30,
   "cache_error_501": 30
}