Guia de Início Rápido

Este guia vai te ajudar a fazer sua primeira requisição à API da Catalisa Platform em menos de 5 minutos.

Pré-requisitos

• client_id (ID da sua organização)
• client_secret (chave secreta da organização)

informação

Se você ainda não possui as credenciais, entre em contato com o administrador da plataforma.

Passo 1: Obter Token de Acesso

Primeiro, você precisa obter um token de acesso usando o fluxo Client Credentials.

cURL

curl -X POST 'https://iam.stg.catalisa.app/oauth/token' \
  -H 'Content-Type: application/json' \
  -d '{
    "grant_type": "client_credentials",
    "client_id": "2194956a-2d0a-4203-89a3-933319d80fa1",
    "client_secret": "seu-client-secret"
  }'

JavaScript

const response = await fetch('https://iam.stg.catalisa.app/oauth/token', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    grant_type: 'client_credentials',
    client_id: '2194956a-2d0a-4203-89a3-933319d80fa1',
    client_secret: 'seu-client-secret',
  }),
});

const { access_token, expires_in } = await response.json();
console.log('Token:', access_token);
console.log('Expira em:', expires_in, 'segundos');

Resposta

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "Bearer",
  "expires_in": 3600
}

dica

Guarde o access_token - você vai precisar dele em todas as requisições subsequentes.

Passo 2: Fazer uma Requisição

Agora que você tem o token, pode fazer requisições aos Building Blocks. Vamos listar os produtos disponíveis:

cURL

curl -X GET 'https://products.stg.catalisa.app/api/v1/products' \
  -H 'Authorization: Bearer SEU_ACCESS_TOKEN' \
  -H 'Content-Type: application/json'

JavaScript

const token = 'SEU_ACCESS_TOKEN';

const response = await fetch('https://products.stg.catalisa.app/api/v1/products', {
  method: 'GET',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json',
  },
});

const data = await response.json();
console.log('Produtos:', data);

Resposta

{
  "data": [
    {
      "type": "products",
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "attributes": {
        "name": "Empréstimo Pessoal",
        "productType": "PERSONAL_LOAN",
        "active": true
      }
    }
  ],
  "meta": {
    "totalItems": 1,
    "totalPages": 1,
    "currentPage": 1
  }
}

Passo 3: Criar um Recurso

Vamos criar uma pessoa no módulo Customers:

cURL

curl -X POST 'https://customers.stg.catalisa.app/api/v1/people' \
  -H 'Authorization: Bearer SEU_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "data": {
      "type": "people",
      "attributes": {
        "name": "Joao da Silva",
        "taxId": "123.456.789-00",
        "email": "joao@exemplo.com"
      }
    }
  }'

JavaScript

const token = 'SEU_ACCESS_TOKEN';

const response = await fetch('https://customers.stg.catalisa.app/api/v1/people', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    data: {
      type: 'people',
      attributes: {
        name: 'Joao da Silva',
        taxId: '123.456.789-00',
        email: 'joao@exemplo.com',
      },
    },
  }),
});

const pessoa = await response.json();
console.log('Pessoa criada:', pessoa.data.id);

Próximos Passos

Agora que você fez sua primeira requisição, explore os demais recursos:

• Autenticação - Aprenda mais sobre OAuth 2.0 e refresh tokens
• Paginação - Entenda como paginar resultados
• Erros - Conheça os códigos de erro da API

Building Blocks

• IAM - Gerencie usuários, organizações e permissões
• Customers - Cadastre e gerencie clientes
• Products - Configure produtos de crédito
• Decision Engine - Motor de decisão para regras de negócio
• Calculations Engine - Calculadoras financeiras