Stone Catalog API

1.0.0OAS 3.0

API inteligente para descoberta e catalogação automática de produtos sob demanda usando agentes de IA especializados e web scraping. Busca informações detalhadas de produtos por código de barras (EAN-13) ou nome do produto.

API Base URL
  • Server 1:https://sdx.api.stone.com.br/v1/catalog

    Ambiente de Desenvolvimento (SDX)

  • Server 2:https://api.stone.com.br/v1/catalog

    Ambiente de Produção (PRD)

Security
BasicAuth (http)

Autenticação Basic com API Key como username e API Secret como password. Use este método apenas para o endpoint /auth/generate-token e somente para aplicações legadas.

BearerAuth (http)

Autenticação via Bearer token. Para aplicações legadas, obtenha um JWT através do endpoint /auth/generate-token usando Basic Auth. Para integrações novas, envie o access token emitido pelo IDP externo com o escopo usr_type/partner_stone_catalog.

OAuth2BearerMcp (http)

Bearer token OAuth2 via Scalekit, exclusivo para o endpoint MCP. O token deve ter como audience o resource_id <BASE_URL>/products/mcp.

ApiKeyAuth (apiKey)

API Key fornecida no momento do cadastro do cliente (DEPRECATED - use BearerAuth)

Authentication

Geração e gestão de tokens de autenticação

Gerar token de acesso

Gera um Bearer token usando client_credentials flow do Cognito. Use o client_id e client_secret da aplicação fornecidos pelo time. O token retornado deve ser enviado como Authorization: Bearer <token> nas chamadas à API.

post

Body

application/x-www-form-urlencoded
grant_typestringrequired

Allowed values:client_credentials

Example:client_credentials

client_idstringrequired

Client ID da aplicação

Example:22st50f99o3uan9forfrb6h3uh

client_secretstringrequired

Client Secret da aplicação

Example:your-client-secret

Response

application/json

Token gerado com sucesso

access_tokenstringrequired

Bearer token JWT para uso nas chamadas à API

token_typestringrequired

Allowed values:Bearer

Example:Bearer

expires_inintegerrequired

Tempo de expiração em segundos

Example:86400

post/auth/realms/payments/oauth2/token

Body

{ "grant_type": "client_credentials", "client_id": "22st50f99o3uan9forfrb6h3uh", "client_secret": "your-client-secret" }
 
application/json