Listar conexões de um projeto
curl --request GET \
--url https://api.metrito.com/v3/projects/{project_id}/connections \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.metrito.com/v3/projects/{project_id}/connections"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.metrito.com/v3/projects/{project_id}/connections', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.metrito.com/v3/projects/{project_id}/connections",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.metrito.com/v3/projects/{project_id}/connections"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.metrito.com/v3/projects/{project_id}/connections")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.metrito.com/v3/projects/{project_id}/connections")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body[
{
"id": "64a1b2c3d4e5f6a7b8c9d0e1",
"source": "Meta Ads",
"source_id": "act_123456789",
"name": "Conta Principal Meta",
"status": "active",
"workspace_id": "60f1b2c3d4e5f6a7b8c9d0e1",
"webhook_url": null
},
{
"id": "64a1b2c3d4e5f6a7b8c9d0e2",
"source": "Google Ads",
"source_id": "123-456-7890",
"name": "Google Ads Loja",
"status": "active",
"workspace_id": "60f1b2c3d4e5f6a7b8c9d0e1",
"webhook_url": null
},
{
"id": "64a1b2c3d4e5f6a7b8c9d0e3",
"source": "Personalizado",
"source_id": null,
"name": "Webhook Hotmart",
"status": "active",
"workspace_id": "60f1b2c3d4e5f6a7b8c9d0e1",
"webhook_url": "https://api.metrito.com/v2/tracking/generic?k=abc123"
}
]{
"error": "Not Found",
"message": "Access denied: User doesn't have read permissions for this project"
}Plataforma
Listar Conexões
Retorna todas as conexões (fontes de dados) vinculadas a um projeto específico.
Cada conexão representa uma conta de anúncios ou fonte de dados integrada (Meta Ads, Google Ads, TikTok Ads, etc.).
GET
/
v3
/
projects
/
{project_id}
/
connections
Listar conexões de um projeto
curl --request GET \
--url https://api.metrito.com/v3/projects/{project_id}/connections \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.metrito.com/v3/projects/{project_id}/connections"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.metrito.com/v3/projects/{project_id}/connections', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.metrito.com/v3/projects/{project_id}/connections",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.metrito.com/v3/projects/{project_id}/connections"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.metrito.com/v3/projects/{project_id}/connections")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.metrito.com/v3/projects/{project_id}/connections")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body[
{
"id": "64a1b2c3d4e5f6a7b8c9d0e1",
"source": "Meta Ads",
"source_id": "act_123456789",
"name": "Conta Principal Meta",
"status": "active",
"workspace_id": "60f1b2c3d4e5f6a7b8c9d0e1",
"webhook_url": null
},
{
"id": "64a1b2c3d4e5f6a7b8c9d0e2",
"source": "Google Ads",
"source_id": "123-456-7890",
"name": "Google Ads Loja",
"status": "active",
"workspace_id": "60f1b2c3d4e5f6a7b8c9d0e1",
"webhook_url": null
},
{
"id": "64a1b2c3d4e5f6a7b8c9d0e3",
"source": "Personalizado",
"source_id": null,
"name": "Webhook Hotmart",
"status": "active",
"workspace_id": "60f1b2c3d4e5f6a7b8c9d0e1",
"webhook_url": "https://api.metrito.com/v2/tracking/generic?k=abc123"
}
]{
"error": "Not Found",
"message": "Access denied: User doesn't have read permissions for this project"
}Autenticação
Este endpoint aceita dois formatos de autenticação:-
JWT da plataforma
- Header:
Authorization: Bearer {jwt}
- Header:
-
API Key do Metrito
- Header:
Authorization: Bearer mtk_live_...oux-api-key: mtk_live_... - Requer escopo
data:read - O projeto deve pertencer ao workspace vinculado à chave
- Header:
Autorizações
bearerAuthapiKeyAuth
JWT da plataforma ou API key mtk_live_... enviada no header Authorization
Parâmetros de caminho
ID do projeto.
Exemplo:
"69162064162b926ae607959b"
Resposta
Lista de conexões retornada com sucesso
ID da conexão
Nome da fonte de dados (Meta Ads, Google Ads, TikTok Ads, Personalizado, etc.)
ID da conta na plataforma de origem (ex. act_123456 para Meta)
Nome dado à conexão pelo usuário
Status atual da conexão
Opções disponíveis:
active, error, paused, disabled ID do workspace
URL do webhook (apenas para conexões do tipo Personalizado)