> ## Documentation Index
> Fetch the complete documentation index at: https://docs.norbaas.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Autenticação

> Autenticar na API de cartões para recuperar o token de acesso para os demais endpoints.

**Scopes**: `cards:write`



## OpenAPI

````yaml post /v1/user/login/
openapi: 3.1.0
info:
  title: Norbaas API
  summary: Norbaas API
  description: Read the docs at https://docs.norbaas.com.br
  version: 0.1.0
servers: []
security: []
tags:
  - name: cards
    description: >-
      Endpoints que devem aparecer no schema apenas em desenvolvimento para
      gerar nosso SDK interno em JavaScript.
  - name: accounts
    description: >-
      Endpoints que devem aparecer no schema apenas em desenvolvimento para
      gerar nosso SDK interno em JavaScript.
  - name: documented
    description: Endpoints exibidos e documentados na documentação da API Norbaas.
  - name: featured
    description: >-
      Endpoints destacados na documentação da API Norbaas por seu interesse em
      casos de uso comuns.
  - name: mcp
    description: Endpoints habilitados no servidor MCP.
paths:
  /v1/user/login/:
    post:
      tags:
        - cards
        - documented
        - featured
        - mcp
      summary: Autenticação
      description: >-
        Autenticar na API de cartões para recuperar o token de acesso para os
        demais endpoints.


        **Scopes**: `cards:write`
      operationId: cards:auth
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CardAuthRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CardAuthentication'
        '401':
          description: Credenciais inválidas
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InvalidCredential'
      security: []
      servers:
        - url: https://sandbox.api.card.revenu.tech
          description: API de cartões
      x-codeSamples: []
components:
  schemas:
    CardAuthRequest:
      type: object
      required:
        - username
        - password
      properties:
        username:
          type: string
          format: email
          example: sandbox@norbaas.com.br
        password:
          type: string
          format: password
          example: '123456'
    CardAuthentication:
      type: object
      title: CardAuthentication
      description: >-
        Recuperar token de acesso para enviar nas requisições de outros
        endpoints.
      required:
        - success
        - accessToken
        - refreshToken
        - userId
      properties:
        accessToken:
          type: string
          title: Access Token
          description: Token de accesso para utilizar nas requisições (Bearer).
          format: jwt
          example: eyJhbGciOeakxpLIsInR5cCIgOi...
        refreshToken:
          type: string
          title: Refresh Token
          description: JWT Refresh Token for session renewal.
          format: jwt
          example: eyJhbGciOiJIUzUxMiIsInR5cC...
        userId:
          type: string
          title: User ID
          format: uuid
    InvalidCredential:
      type: object
      title: Credenciais inválidas
      description: Erro retornado quando as credenciais de autenticação são inválidas.
      required:
        - message
        - error
        - statusCode
      properties:
        message:
          type: string
          example: Invalid credentials.
          description: Mensagem explicando o erro.
        error:
          type: string
          example: Unauthorized
          description: Tipo do erro HTTP.
        statusCode:
          type: integer
          example: 401
          description: Código HTTP correspondente ao erro.

````