Mediahub Rest API
  1. Tray
Mediahub Rest API
  • Introdução
  • API Reference
    • Facebook Ads
      • Accounts
      • Ads [Ad Level]
      • Ads Config [Ad Level]
      • Ads [Adset Level]
      • Ads Config [Adset Level]
      • Ads [Campaign Level]
      • Ads Config [Campaign Level]
      • Ads Actions
      • Ads Gender/Age
      • Ads Region
      • Ads Platform
      • Creatives [Deprecated]
      • Creatives with Ad
    • Google Ads
      • Accounts
      • Ads Conversions
      • Ads [Ad Group]
      • Ads [Conversion Segmented Ad Group]
      • Ads [Ad Group Ads]
      • Ads Criterion [Ad Group Ads]
      • Ads [Conversion Segmented Ad Group Ads]
      • Ads [Campaigns]
      • Ads Criterion [Campaigns]
      • Ads [Conversion Segmented Campaigns]
      • Ads Age Dimension
      • Ads Gender Dimension
      • Ads Geographic Dimension
      • Ads Keywords Dimension
    • Google Analytics
      • Google Analytics Customers
      • Google Analytics Custom Events
      • Google Analytics Events
      • Google Analytics Products
      • Google Analytics Sessions
      • Google Analytics Transactions
    • Instagram Insights
      • Instagram Age Insights
      • Instagram City Insights
      • Instagram Gender Insights
      • instagram Media Details
      • Instagram Media Insights
      • Instagram Profile
      • Instagram Profile Insights
    • TikTok
      • TikTok Budget
      • TikTok Demographic
      • TikTok Group Budget
      • TikTok Info
      • TikTok Region
    • Linkedin
      • Linkedin Statistics
      • Linkedin Accounts Campaigns
      • Linkedin Conversions Tracking
    • Bitrix
      • Bitrix Contacts
      • Bitrix Deals
      • Bitrix Won Deals
      • Bitrix Leads History
    • Kommo
      • Kommo Contacts
      • Kommo Leads
      • Kommo Pipelines
      • Kommo Users
    • Loja Integrada
      • Loja Integrada Customers
      • Loja Integrada Orders
      • Loja Integrada Products
    • Nuvem Shop
      • Nuvem Shop Customers
      • Nuvem Shop Orders
      • Nuvem Shop Products
    • Pipedrive
      • Pipedrive Deals
      • Pipedrive Leads
      • Pipedrive Lead Sources
      • Pipedrive People
      • Pipedrive Pipelines
      • Pipedrive Pipeline Stages
      • Pipedrive Products
      • Pipedrive Users
    • Rd Station
      • Rd Station Deal Stages
      • Rd Station Deals
      • Rd Station Products
    • Shopify
      • Shopify Customers
      • Shopify Orders
      • Shopify Orders Items
      • Shopify Products
    • Tray
      • Tray Customers
        GET
      • Tray Orders
        GET
      • Tray Products
        GET
    • Unbounce
      • Unbounce Leads
    • Vtex
      • Vtex Customers
      • Vtex Orders
      • Vtex Products
    • Investimentos de Mídia
      • Investimentos de Mídia
    • Integrações
      • Integrações
  1. Tray

Tray Products

GET
https://rest.api.mktlab.app/v1/tray/products

Resposta#

A resposta retorna uma lista de produtos presentes em pedidos na Tray, com os seguintes campos:
CampoTipoDescrição
quantitynumberQuantidade do produto no pedido.
product_idstringID único do produto na plataforma Tray.
sold_product_idstringID do produto vendido, se for diferente do product_id.
order_idstringID do pedido ao qual o produto está associado.
namestringNome do produto.
pricenumberPreço do produto no pedido (antes de qualquer desconto ou promoção).
cost_pricenumberPreço de custo do produto para o vendedor.
original_pricenumberPreço original do produto, sem considerar qualquer alteração de preço ou desconto.
brandstringMarca do produto.
modelstringModelo do produto.
commissionnumberComissão atribuída ao vendedor pelo produto vendido.
product_imagestringURL da imagem do produto.
categorystringCategoria à qual o produto pertence.
urlstringURL do produto na plataforma Tray, para mais detalhes.
integration_idstringID da integração do sistema com a Tray.
project_idstringID do projeto associado ao produto.
unit_idstringID da unidade de negócios associada ao produto.
document_idstringID do documento relacionado ao produto (ex: nota fiscal).
inserted_atDateData e hora em que o produto foi inserido no sistema (formato ISO 8601).

Exemplo de JSON com os Resultados Esperados#

Requisição

Authorization
Forneça seu token bearer no cabeçalho
Authorization
ao fazer requisições para recursos protegidos.
Exemplo:
Authorization: Bearer ********************
Parâmetros de Consulta

Respostas

🟢200Tray Products
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://rest.api.mktlab.app/v1/tray/products' \
--header 'Authorization: Bearer <token>'
Response Response Example
{
    "data": [
        {
            "quantity": 2,
            "product_id": "PROD123",
            "sold_product_id": "SOLD123",
            "order_id": "ORD123456",
            "name": "Produto Exemplo",
            "price": 100,
            "cost_price": 70,
            "original_price": 120,
            "brand": "Marca Exemplo",
            "model": "Modelo X",
            "commission": 10,
            "product_image": "https://link.com/imagem-do-produto.jpg",
            "category": "Eletrônicos",
            "url": "https://www.tray.com.br/produto/PROD123",
            "integration_id": "INTEGR123",
            "project_id": "PROJ123",
            "unit_id": "UNIT123",
            "document_id": "DOC123",
            "inserted_at": "2025-01-01T09:00:00Z"
        }
    ],
    "meta": {
        "page": 1,
        "limit": 500,
        "total": 1,
        "totalPages": 1,
        "hasNextPage": false,
        "hasPreviousPage": true
    }
}
Modificado em 2025-10-08 17:25:55
Página anterior
Tray Orders
Próxima página
Unbounce Leads
Built with