Buscar produto

Retorna um produto pelo seu hash. Escopo: products:read. Retorna 404 se o produto não for do produtor autenticado.

GET /api/v2/products/{hash}

Buscar produto

cURL

curl --request GET \
  --url https://api.ticto.cloud/api/v2/products/{hash} \
  --header 'Authorization: Bearer <token>'

200

{
  "object": "product",
  "id": "PABC123",
  "reference_id": 42,
  "name": "Curso de Marketing Digital",
  "type": "course",
  "status": "approved",
  "is_active": true,
  "created_at": "2023-11-07T05:31:56Z"
}

Authorizations

Authorization · string · header · required

Token opaco no formato ticto_live_... (produção) ou ticto_test_... (sandbox). Enviado como Authorization: Bearer <token>.

Path Parameters

hash · string · required

Hash do produto (identificador canônico da API, ex.: PABC123).

Response

200

application/json

Produto.

object · string

Example:

"product"

id · string

Hash do produto — identificador canônico da API.

Example:

"PABC123"

reference_id · integer

ID numérico legado (reconcilia com a dashboard). Não é fronteira de segurança.

Example:

42

name · string

Example:

"Curso de Marketing Digital"

type · string

Example:

"course"

status · string · read-only

Status do produto, gerido pela plataforma. Somente leitura: não pode ser enviado nem alterado pela API.

Example:

"approved"

is_active · boolean

Se o produto está ativo (disponível). Controlado pelo produtor via is_active na criação.

Example:

true

created_at · string<date-time>