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

# Find Roblox User

> Busca um usuário do Roblox pelo nome de usuário e devolve o avatar.
<Note>Serve para validar campos do tipo `ROBLOX` no checkout. Antes de enviar o pedido, confirme que o nome digitado existe e mostre o avatar para o comprador conferir que é a conta certa. A consulta bate na API pública do Roblox em tempo real, então a latência depende de um terceiro.</Note>



## OpenAPI

````yaml /openapi/storefront-utils.yaml get /webstore/roblox
openapi: 3.1.0
info:
  title: CentralCart Storefront API (Utilitários)
  version: 1.0.0
  description: Endpoints auxiliares do storefront.
servers:
  - url: https://api.centralcart.io/v1
    description: Produção
security: []
paths:
  /webstore/roblox:
    get:
      tags:
        - Utilitarios
      summary: Find Roblox User
      description: >-
        Busca um usuário do Roblox pelo nome de usuário e devolve o avatar.

        <Note>Serve para validar campos do tipo `ROBLOX` no checkout. Antes de
        enviar o pedido, confirme que o nome digitado existe e mostre o avatar
        para o comprador conferir que é a conta certa. A consulta bate na API
        pública do Roblox em tempo real, então a latência depende de um
        terceiro.</Note>
      operationId: findWebstoreRobloxUser
      parameters:
        - $ref: '#/components/parameters/StoreDomain'
        - name: username
          in: query
          required: true
          description: Nome de usuário do Roblox (exato, não é busca parcial).
          schema:
            type: string
      responses:
        '200':
          description: Usuário encontrado
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: number
                    description: ID numérico do usuário no Roblox.
                  username:
                    type: string
                    description: Nome de usuário canônico, já com a capitalização correta.
                  display_name:
                    type: string
                  avatar_url:
                    type: string
                    description: URL do headshot do avatar, 150x150 PNG.
              example:
                id: 1234567
                username: jogador123
                display_name: Jogador
                avatar_url: https://tr.rbxcdn.com/.../150/150/AvatarHeadshot/Png
        '400':
          description: '`username` ausente, ou falha ao consultar o Roblox'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                errors:
                  - message: Erro ao buscar dados do usuário.
      security: []
components:
  parameters:
    StoreDomain:
      name: x-store-domain
      in: header
      required: true
      description: 'Domínio da sua loja (ex: sualoja.centralcart.ai)'
      schema:
        type: string
  schemas:
    Error:
      type: object
      properties:
        errors:
          type: array
          items:
            type: object
            properties:
              message:
                type: string
              code:
                type: string
              ref:
                type: string

````