🚧 Em Construção 🚧
Skip to main content

Criar um novo asset

POST 
/v1/assets

Um asset (ou ativo) é um recurso de valor econômico que pode ser possuído ou controlado por uma entidade, indivíduo ou instituição. No contexto financeiro, um ativo pode ser:

  • Fiduciário, quando seu valor é respaldado por um emissor de confiança, como moedas emitidas por governos ou títulos lastreados.

  • Não fiduciário, quando seu valor deriva de características intrínsecas ou da demanda do mercado. Entre esses ativos, podem estar commodities, criptomoedas e bens tangíveis, como um carro ou até mesmo contas (pedras historicamente utilizadas como meio de troca).

Os assets fiduciários, baseados na ISO 4712, já estão disponíveis para uso no Guardia, mas você pode criar novos assets conforme sua necessidade. Os demais assets podem ser baseados em especificações como ISO 10962, MIC, ISIN ou um padrão interno da instituição.

Request​

Responses​

Asset criado

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