Menerima Email: Kirim & kepercayaan

Ambil pelacakan

Mengembalikan pembukaan dan klik email yang dikirim oleh mailbox ini. Hanya baca.

POSThttps://g.sendcorex.com/v1command: get_tracking
i

Hanya pesan yang dikirim dengan pelacakan yang muncul di hasil.

i

Pembukaan dari bot dan proxy tidak dihitung.

!

Angka pembukaan adalah perkiraan: beberapa aplikasi email memuat gambar otomatis atau memblokirnya.

i

Status setiap pesan disimpan selama 180 hari.

Argumen

  • idsstring[]wajib

    1 sampai 200 message_uid pesan terkirim. Berasal dari Sent, dari respons send_email / reply, atau dari list_messages.

Mulai cepat

import axios from 'axios';

const response = await axios.post(
  'https://g.sendcorex.com/v1',
  {
    commands: [
      {
        command: "get_tracking",
        args: {
          ids: [
            "Vj0xQUJDMTIz",
            "Vj0xQUJDMTI0"
          ]
        }
      }
    ]
  },
  { headers: { Authorization: process.env.SENDCOREX_TOKEN } },
);

const [result] = response.data.results;
if (result.type !== 'SUCCESS') throw new Error(`${result.code}: ${result.message}`);
console.log(result.data);

Respons

{
  "type": "SUCCESS",
  "results": [
    {
      "command": "get_tracking",
      "id": "0",
      "type": "SUCCESS",
      "data": {
        "tracking": {
          "Vj0xQUJDMTIz": {
            "track_opens": true,
            "track_clicks": true,
            "opens": 3,
            "clicks": 1,
            "first_open_at": "2026-11-21T07:10:00Z",
            "last_open_at": "2026-11-21T09:42:00Z",
            "last_click_at": "2026-11-21T09:43:00Z",
            "unsubscribe": true,
            "unsubscribes": 0,
            "recipients": [
              {
                "email": "ana@empresa.com",
                "opens": 3,
                "clicks": 1,
                "last_at": "2026-11-21T09:43:00Z",
                "unsubscribed": false,
                "urls": [
                  {
                    "url": "https://acme.com/pricing",
                    "at": "2026-11-21T09:43:00Z",
                    "clicks": 1
                  }
                ]
              }
            ]
          }
        }
      }
    }
  ]
}

Field respons

  • tracking.<message_uid>

    Satu entri per pesan yang dikirim dengan pelacakan. Pesan tanpa pelacakan tidak dicantumkan.

  • track_opens / track_clicks

    Apa yang dilacak saat email dikirim.

  • opens / clicks

    Total dari semua penerima.

  • first_open_at / last_open_at / last_click_at

    Aktivitas pertama dan terakhir (UTC), atau null.

  • unsubscribe / unsubscribes

    Apakah email memiliki link berhenti berlangganan, dan berapa penerima yang berhenti berlangganan lewat link itu.

  • recipients

    Per penerima: email, opens, clicks, last_at, unsubscribed, dan urls (setiap tautan yang diklik, terbaru dulu, dengan url, at klik terakhir, dan clicks; [] jika orang itu tidak mengeklik).

Pelacakan

Cara pembukaan dan klik diukur.

Pembukaan

Setiap email membawa piksel tak terlihat. Saat aplikasi penerima memuatnya, satu pembukaan dihitung. Beberapa aplikasi memuat gambar sendiri atau memblokirnya, jadi angkanya adalah perkiraan.

Klik

Setiap link melewati pengalihan yang menghitung klik dan langsung membawa penerima ke alamat aslinya.

Privasi

Penerima yang menolak pelacakan di halaman preferensi tidak pernah dilacak. Untuk mematikan pelacakan pada satu email, kirim track_opens: false dan track_clicks: false.

Error

Error di level HTTP mengembalikan type, code, dan message. Error yang ditandai CMD dikembalikan di dalam hasil perintah, dengan HTTP 200.

  • 401TOKEN_EXPIRED

    Access token sudah kedaluwarsa. Panggil Refresh Token lalu ulangi request.

  • 401INVALID_TOKEN

    Token salah format, tidak dikenal, atau dicabut.

  • 429RATE_LIMITED

    Lebih dari 15 request/detik atau 15 yang sedang diproses untuk IP + kotak surat yang sama. Tunggu sesuai jumlah detik di Retry-After.

  • CMDINVALID_ARGS

    Argumen wajib tidak ada atau tidak valid.

  • CMDINTERNAL

    Error server. Detailnya hanya ditulis ke log server.