Integrações
GET
https://rest.api.mktlab.app/v1/customer-integrations/integrations
statusResposta
| Campo | Tipo | Descrição |
|---|---|---|
_id | string | Identificador único da integração. |
project_id | string | ID do projeto associado à integração. |
integration_id | string | ID da integração da plataforma ou sistema externo. |
name | string | Nome da integração. |
project_name | string | Nome do projeto vinculado à integração. |
type | string | Tipo da integração (Channel Type + Endpoint, ex: FACEBOOK_ADS_ACTIONS). |
customer_id | string | ID do cliente associado à integração (legado). |
customer_new_id | string | Novo ID do cliente no sistema atualizado. |
user_id | string | ID do usuário responsável pela integração. |
unit_id | string | ID da unidade de negócios associada. |
status | number | Status atual da integração (ex: 1,2,3 ou 4). |
date_history | Date | Data do histórico de retorno de dados da integração. |
update_frequency | number[] | Frequência de atualização dos dados (horários do dia representados pelos seus números). |
email | string | E-mail de contato para notificações ou alertas da integração. |
channel | string | Canal ou plataforma relacionada à integração (FACEBOOK_ADS, GOOGLE_ADS, GOOGLE_ANALYTICS, INSTAGRAM, BITRIX, KOMMO, LINKEDIN, LOJA_INTEGRADA, PIPEDRIVE, RDSTATION, SHOPIFY, TIKTOK, TRAY, VTEX). |
created_at | Date | Data de criação da integração no sistema. |
updated_at | Date | Data da última atualização da integração. |
status_updated_at | Date | Data da última alteração de status da integração pelos serviços. |
last_task_date | Date | Data da última execução da tarefa de extração de dados relacionada à integração. |
last_task_log | string | Log da última execução da tarefa de extração de dados. |
data_updated_at | Date | Data da última atualização dos dados da integração no banco de dados. |
Requisição
Parâmetros de Consulta
Respostas
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://rest.api.mktlab.app/v1/customer-integrations/integrations' \
--header 'Authorization: Bearer <token>'Response Response Example
{
"data": [
{
"_id": "682b26b464abdbbf890f1234",
"project_id": "659d84d777f690b44d4b1234",
"integration_id": "act_507029406021234",
"name": "Projeto XYZ - Conta 01",
"project_name": "Projeto 123",
"type": "FACEBOOK_ADS_ACTIONS",
"customer_id": "659d84d777f690b44d4b1234",
"customer_new_id": "659d84d777f690b44d4b1234",
"user_id": "65538b33aa8ac93902e01234",
"unit_id": "63b5bea69e9f728357581234",
"status": 1,
"date_history": "2025-02-18",
"update_frequency": [
12
],
"email": "user@v4company.com",
"channel": "FACEBOOK_ADS",
"created_at": "2025-05-19T09:40:20.026Z",
"updated_at": "2025-05-19T09:40:20.026Z",
"status_updated_at": "2025-05-19T09:41:14.821Z",
"last_task_date": "2025-05-19T09:41:14.821Z",
"last_task_log": "Successfully extracted 25 records.",
"data_updated_at": "2025-05-19T09:41:19.308Z"
}
],
"meta": {
"page": 1,
"limit": 500,
"total": 0,
"totalPages": 0,
"hasNextPage": false,
"hasPreviousPage": false
}
}Modificado em 2025-10-08 17:25:55