> ## Documentation Index > Fetch the complete documentation index at: https://docs.metrito.com/llms.txt > Use this file to discover all available pages before exploring further. # Obter Container > Retorna informações completas de um container de rastreamento, incluindo domínio, gatilhos configurados e pixels vinculados. O parâmetro `container_id` aceita **três formatos** de identificação: | Formato | Exemplo | Onde encontrar | |---------|---------|----------------| | **ObjectId** do Metrito | `64a1b2c3d4e5f6a7b8c9d0e1` | Na URL da plataforma após `/containers/` | | **Domínio** (containers v2) | `minhaloja.com.br` | O domínio real configurado no container | | **Metrito Tracking Code** (containers v3) | `MTC-AB12` | Na sidebar da plataforma, página de Tracking | ## Identificando o container O parâmetro `container_id` é flexível e aceita qualquer um dos três formatos abaixo: | Formato | Exemplo | Quando usar | | -------------------------- | ----------------------------------- | ----------------------------------------------------------------------- | | ObjectId Metrito | `64a1b2c3d4e5f6a7b8c9d0e1` | Obtido via URL da plataforma (`/containers/{id}`) ou via API | | Domínio (v2) | `minhaloja.com.br`, `advera.com.br` | Containers legados v2 — use o domínio real | | Metrito Tracking Code (v3) | `MTC-AB12` | Containers v3 — visível na sidebar da plataforma, na página de Tracking | O **Metrito Tracking Code** (MTC) é a forma mais fácil de identificar containers v3. Ele aparece diretamente na sidebar da plataforma e é curto e fácil de copiar. ### Exemplos de chamada **Por ObjectId:** ```bash curl https://api.metrito.com/v3/tracking/containers/64a1b2c3d4e5f6a7b8c9d0e1 \ -H "Authorization: Bearer mtk_live_..." ``` **Por domínio (v2):** ```bash curl https://api.metrito.com/v3/tracking/containers/minhaloja.com.br \ -H "Authorization: Bearer mtk_live_..." ``` **Por Metrito Tracking Code (v3):** ```bash curl https://api.metrito.com/v3/tracking/containers/MTC-AB12 \ -H "Authorization: Bearer mtk_live_..." ``` ## OpenAPI ````yaml /openapi/tracking.yaml get /v3/tracking/containers/{container_id} openapi: 3.1.0 info: title: API de Rastreamento — Metrito version: '3.0' description: > API para envio de eventos de rastreamento, gerenciamento de gatilhos (triggers) e webhooks de transação. ## Conceitos - **Container** — O contêiner de rastreamento vinculado a um domínio. - **Gatilho (Trigger)** — Uma *configuração* que define quando e como uma conversão deve ser disparada (tipo de disparo, mapeamento Meta, condições). Recurso CRUD. - **Evento** — Um *dado de rastreamento* enviado em tempo real: "usuário visualizou página X", "usuário comprou Y". Transitório, processado via fila. ## Infraestrutura - Rate limiting via `X-RateLimit-*` headers - Request ID via `X-Request-Id` em todas as respostas - `Idempotency-Key` suportado em POSTs de criação e ingestão servers: - url: https://api.metrito.com description: Produção security: - bearerAuth: [] - apiKeyAuth: [] paths: /v3/tracking/containers/{container_id}: get: summary: Obter container description: > Retorna informações completas de um container de rastreamento, incluindo domínio, gatilhos configurados e pixels vinculados. O parâmetro `container_id` aceita **três formatos** de identificação: | Formato | Exemplo | Onde encontrar | |---------|---------|----------------| | **ObjectId** do Metrito | `64a1b2c3d4e5f6a7b8c9d0e1` | Na URL da plataforma após `/containers/` | | **Domínio** (containers v2) | `minhaloja.com.br` | O domínio real configurado no container | | **Metrito Tracking Code** (containers v3) | `MTC-AB12` | Na sidebar da plataforma, página de Tracking | operationId: getContainer parameters: - $ref: '#/components/parameters/ContainerId' responses: '200': description: Container retornado com sucesso content: application/json: schema: $ref: '#/components/schemas/ContainerResponse' examples: v2_container: summary: Container v2 (domínio real) value: id: 64a1b2c3d4e5f6a7b8c9d0e1 domain: minhaloja.com.br alias: Minha Loja version: '2.0' status: valid_receive_events verified_domains: - domain: minhaloja.com.br status: verified linked_pixels: - source: meta_ads id: '1234567890' name: Pixel Principal triggers: - id: 64a1b2c3d4e5f6a7b8c9d0e2 name: Compra Aprovada trigger_type: api facebook_event_name: Purchase metadata: allowed_hosts: - minhaloja.com.br lead_key: mlid has_funnel_steps: false v3_container: summary: Container v3 (Metrito Tracking Code) value: id: 67e1a2b3c4d5e6f7a8b9c0d1 domain: MTC-AB12 alias: Minha Loja v3 version: '3.0' status: valid_receive_events verified_domains: [] linked_pixels: - source: meta_ads id: '9876543210' name: Pixel CAPI triggers: - id: 67e1a2b3c4d5e6f7a8b9c0d2 name: Lead Cadastrado trigger_type: api facebook_event_name: Lead metadata: allowed_hosts: [] lead_key: mlid has_funnel_steps: true '401': $ref: '#/components/responses/Unauthorized' '404': $ref: '#/components/responses/NotFound' security: - bearerAuth: [] - apiKeyAuth: [] components: parameters: ContainerId: name: container_id in: path required: true description: > Identificador do container. Aceita três formatos: - **ObjectId** — `64a1b2c3d4e5f6a7b8c9d0e1` (encontrado na URL da plataforma após `/containers/`) - **Domínio** — `minhaloja.com.br` (containers v2, o domínio real) - **Metrito Tracking Code** — `MTC-AB12` (containers v3, visível na sidebar da plataforma) schema: type: string examples: - 64a1b2c3d4e5f6a7b8c9d0e1 - minhaloja.com.br - MTC-AB12 schemas: ContainerResponse: type: object properties: id: type: string domain: type: string alias: type: string nullable: true version: type: string status: type: string enum: - valid_receive_events - pending_receive_events - not_receiving_events_p24h - pending - deleted verified_domains: type: array items: type: object properties: domain: type: string status: type: string linked_pixels: type: array items: type: object properties: source: type: string id: type: string name: type: string triggers: type: array description: Gatilhos configurados no container (resumo) items: type: object properties: id: type: string name: type: string trigger_type: type: string facebook_event_name: type: string nullable: true metadata: type: object properties: allowed_hosts: type: array items: type: string lead_key: type: string nullable: true has_funnel_steps: type: boolean ErrorResponse: type: object properties: error: type: object properties: type: type: string enum: - authentication_error - authorization_error - validation_error - rate_limit_error - not_found_error - api_error code: type: string message: type: string request_id: type: string nullable: true responses: Unauthorized: description: API key ausente, inválida, revogada ou expirada content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: type: authentication_error code: invalid_api_key message: The API key provided is invalid or has been revoked. request_id: req_abc123 NotFound: description: Recurso não encontrado content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: type: not_found_error code: resource_not_found message: Trigger not found request_id: req_abc123 securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT or API Key description: JWT da plataforma ou API key `mtk_live_...` apiKeyAuth: type: apiKey in: header name: x-api-key description: API key `mtk_live_...` via header `x-api-key` ````