Criar Produto

Quando uma Produto é criado com sucesso, a API retorna o código de status HTTP 201 Created, com os dados da Produto criado no corpo da resposta.

Segurança

Para acessar a API, é necessário obter um token de acesso através do fluxo de autenticação OAuth2. Veja mais detalhes em Como obter acesso?

info

Ao gerar o token JWT, não esqueça de utilizar o escopo correto. Caso contrário, a requisição será rejeitada com o código de erro 401 Unauthorized.

Descrição dos campos

Campo	Tipo	Descrição
description	string	Descrição do produto.
active	boolean	Define se o produto está ativo.
ownerId	string	Identificador único do parceiro, no formato UUID.

Requisição

POST https://api-sandbox.catalisa.com.br/financial-products/api/v1/products JWT scope: products/create:products

Parâmetros

Sem parâmetros

Cabeçalhos

Nome	Valor
Authorization	Bearer <token>
Content-Type	application/json

Exemplo de Requisição

Corpo da Requisição

{
  "data": {
    "type": "products",
    "attributes": {
      "description": "Empréstimo Pessoal (EP)",
      "active": true,
      "ownerId": "e8fc74b6-273c-4139-afb4-0fefc60750d6"
    }
  }
}

Respostas

Código	Descrição
201	Produto criado com sucesso. Retorna os dados do produto criado
401	Não autorizado

Exemplo de uso

Javascript

const headers = new Headers();
headers.append("Authorization", "Bearer <token>");
headers.append("Content-Type", "application/json");

const body = JSON.stringify({
  data: {
    type: "products",
    attributes: {
      description: "Empréstimo Pessoal (EP)",
      active: true,
      ownerId: "e8fc74b6-273c-4139-afb4-0fefc60750d6"
    }
  }
};

const requestOptions = {
  method: "POST",
  headers: headers,
  body: body,
};

const response = await fetch(
  "https://api-sandbox.catalisa.com.br/financial-products/api/v1/products",
  requestOptions
);
const data = await response.json();
console.log(data);

CURL

curl --location --request POST 'https://api-sandbox.catalisa.com.br/financial-products/api/v1/products' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <token>' \
--data-raw '{
  "data": {
    "type": "products",
    "attributes": {
      "description": "Empréstimo Pessoal (EP)",
      "active": true,
      "ownerId": "e8fc74b6-273c-4139-afb4-0fefc60750d6"
    }
  }
}'

Exemplo de Sucesso

{
    "data": {
        "type": "products",
        "id": "1752d90e-3066-4341-960f-0bf08b48835f",
        "attributes": {
            "active": true,
            "description": "Empréstimo Pessoal (EP)",
            "ownerId": "e8fc74b6-273c-4139-afb4-0fefc60750d6"
        },
        "relationships": {
            "partner": {
                "links": {
                    "self": "https://api-sandbox.catalisa.com.br/partners/api/v1/partners/e8fc74b6-273c-4139-afb4-0fefc60750d6"
                },
                "data": {
                    "type": "partners",
                    "id": "e8fc74b6-273c-4139-afb4-0fefc60750d6"
                }
            }
        },
        "links": {
            "self": "https://api-sandbox.catalisa.com.br/financial-products/api/v1/products/1752d90e-3066-4341-960f-0bf08b48835f"
        }
    }
}