🚧 Em Construção 🚧
Pular para o conteúdo principal

Atualiza um asset específico

PATCH 
/v1/assets/:entity_id

Atualiza os dados como Nome, Código, Número, Expoente, Locations e Metadata de um asset existente.


atenção

Ao atualizar um metadata, quando o valor for null, caso a propriedade exista, ela será considerada para remoção, conforme a especificação do Json Merge Patch RFC 7386.

Request​

Responses​

Asset atualizado com sucesso.

Response Headers
    Cache-Control

    Controla o comportamento de cache para respostas HTTP. Deve ser 'no-store' para dados sensíveis. Deve ser 'public' para respostas de sucesso sem dados sensíveis que podem ser compartilhadas, ou 'private' para respostas de sucesso sem dados sensíveis que não podem ser compartilhadas, seguido da diretiva 'max-age' determinando o tempo máximo de cache em segundos.

    Example: public, max-age=900
    Content-Digest

    Hash do payload usado para garantir integridade em requisições idempotentes.

    Example: sha-256=<hash>
    Content-Language

    O idioma em que a API retorna as mensagens de erro. Use en para inglês americano, es para espanhol ou pt-BR para português brasileiro.

    Example: en
    Content-Length

    Indica o tamanho, em bytes, do corpo da resposta retornado pela API.

    Example: <length>
    Content-Type

    Tipo de contrato retornado.

    Example: application/vnd.guardia.v1+json
    Idempotency-Key

    Chave para garantir idempotência da requisição.

    Example: 018f74a6e3b270ccbf248a4b012f5f3e
    Last-Modified

    Indica a última data de modificação de uma entidade.

    Example: Wed, 21 Oct 2015 07:28:00 GMT
    Strict-Transport-Security

    Indica que o navegador deve acessar o site apenas por HTTPS.

    Example: max-age=31536000; includeSubDomains
    X-Grd-Correlation-Id

    Identificador de correlação para rastreamento distribuído.

    Example: 018f74a6e3b270ccbf248a4b012f5f3e
    X-Grd-Trace-Id

    Identificador único da requisição gerado pela infraestrutura Guardia.

    Example: 018f74a6e3b270ccbf248a4b012f5f3e
    X-RateLimit-Limit

    Cota de requisições por segundos por cliente (org id + tenant id).

    Example: 30
    X-RateLimit-Remaining

    Cota de requisições restantes no mesmo segundo.

    Example: 10
    X-RateLimit-Reset

    Tempo restante em segundos para a próxima requisição.

    Example: 60