RevRake API'si.

Temel URL'ler

API, operatörün platformu için dört imzalı endpoint'ten (ikisi yazma, ikisi okuma için) ve ziyaretçilerin açtığı takip linkinden oluşur. İmzalı endpoint'ler ayrıca bir OpenAPI 3.1 dosyası olarak yayımlanır.

app.revrake.com adresindeki portallar, oturum açmış bir kullanıcının arkasında kendi endpoint'lerini kullanır. Bunlar herkese açık bir API değildir ve haber verilmeden değişebilir. Raporlar, defter ve ödeme satırları oradan CSV olarak da indirilebilir.

Anahtarlar

İki tür anahtar vardır. Her birinin bir anahtar ID'si ve bir gizli anahtarı vardır ve her biri istekleri aynı şekilde imzalar. Anahtarlar asla paylaşılmaz: her tarafın kendi anahtarı vardır.

• Her iki türde de yeni bir anahtar eskisini hemen iptal eder. Bir affiliate anahtarını iptal edip anahtarsız da kalabilir.
• Bir affiliate anahtarı yalnızca affiliate programda onaylıyken çalışır. Aksi halde bir okuma 403 affiliate_inactive ile yanıtlanır.
• Bir affiliate anahtarıyla affiliate parametresi yok sayılır ve by=affiliate gün bazında yanıtlanır.
• Okumaların hız sınırı anahtar başına sayılır.

Kimlik doğrulama

Her /v1 isteği bir anahtarla imzalanır. Her istek üç başlık taşır:

Bir isteği imzalamak için:

1. Gövdeyi oluşturun ve göndereceğiniz baytları aynen saklayın.
2. Saniye cinsinden geçerli Unix zamanını ondalık metin olarak alın.
3. Zaman damgasını, bir noktayı (.) ve gövdeyi art arda ekleyin.
4. Bunun HMAC-SHA256'sını gizli anahtarınızla hesaplayın ve küçük harfli hex olarak yazın.
5. Gövdeyi değiştirmeden, üç başlıkla birlikte gönderin.

Bir okumayı imzalama

Bir GET isteğinin gövdesi yoktur; bu nedenle imza onun yerine istek hedefini kapsar: yol ve sorgu, tam olarak gönderildiği haliyle, örneğin 1790000000./v1/reports?by=link&days=7. Sorgu yoksa imzalanan metin zaman damgası, bir nokta ve yoldur. Adresi bir kez oluşturun, o metni imzalayın ve o metni gönderin: imzaladıktan sonra sorguyu yeniden sıralayan veya yeniden kodlayan bir istemci imzayı bozar.

• Önce anahtar, sonra zaman damgası, sonra imza kontrol edilir.
• Content-Type başlığı zorunlu değildir. Olaylar için application/json, dosyalar için text/csv gönderin.
• Yenilenen bir anahtar hemen çalışmayı durdurur.

İmzalama örnekleri

Her örnekte tek bir imzalama fonksiyonu vardır; örnek bir kayıt gönderir ve ardından bir rapor okur. Anahtar ID'sini ve gizli anahtarı kendinizinkilerle değiştirin.

KEY="pb_your_key_id"
SECRET="your_secret"
BASE="https://app.revrake.com"

# sign <payload>: hex HMAC-SHA256 of "<timestamp>.<payload>" under the secret
sign() { printf '%s.%s' "$TS" "$1" | openssl dgst -sha256 -hmac "$SECRET" -hex | sed 's/^.* //'; }

# Write: the payload is the body.
TS=$(date +%s)
BODY='{"type":"registration","player_id":"PLR-1001","click_id":"CID_FROM_LANDING_URL"}'
curl -X POST "$BASE/v1/postback" \
  -H "Content-Type: application/json" \
  -H "X-RevRake-Key: $KEY" \
  -H "X-RevRake-Timestamp: $TS" \
  -H "X-RevRake-Signature: $(sign "$BODY")" \
  -d "$BODY"

# Read: the payload is the path and the query, exactly as sent.
TS=$(date +%s)
TARGET='/v1/reports?by=link&days=7'
curl "$BASE$TARGET" \
  -H "X-RevRake-Key: $KEY" \
  -H "X-RevRake-Timestamp: $TS" \
  -H "X-RevRake-Signature: $(sign "$TARGET")"

import { createHmac } from 'node:crypto';

const KEY = 'pb_your_key_id';
const SECRET = 'your_secret';
const BASE = 'https://app.revrake.com';

// hex HMAC-SHA256 of "<timestamp>.<payload>" under the secret
function sign(secret, timestamp, payload) {
  return createHmac('sha256', secret).update(`${timestamp}.${payload}`).digest('hex');
}

function headers(payload) {
  const ts = Math.floor(Date.now() / 1000).toString();
  return { 'X-RevRake-Key': KEY, 'X-RevRake-Timestamp': ts, 'X-RevRake-Signature': sign(SECRET, ts, payload) };
}

// Write: the payload is the body. Send the same string you signed.
const body = JSON.stringify({ type: 'registration', player_id: 'PLR-1001', click_id: 'CID_FROM_LANDING_URL' });
const write = await fetch(`${BASE}/v1/postback`, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', ...headers(body) },
  body,
});
console.log(write.status, await write.json());

// Read: the payload is the path and the query, exactly as sent.
const target = '/v1/reports?by=link&days=7';
const read = await fetch(BASE + target, { headers: headers(target) });
console.log(read.status, await read.json());

import hashlib
import hmac
import json
import time
import urllib.error
import urllib.request

KEY = "pb_your_key_id"
SECRET = "your_secret"
BASE = "https://app.revrake.com"


def sign(secret: str, timestamp: str, payload: bytes) -> str:
    """hex HMAC-SHA256 of "<timestamp>.<payload>" under the secret"""
    return hmac.new(secret.encode(), timestamp.encode() + b"." + payload, hashlib.sha256).hexdigest()


def call(method: str, target: str, body: bytes | None = None):
    ts = str(int(time.time()))
    # Write: the payload is the body. Read: the path and the query, as sent.
    payload = body if body is not None else target.encode()
    headers = {"X-RevRake-Key": KEY, "X-RevRake-Timestamp": ts, "X-RevRake-Signature": sign(SECRET, ts, payload)}
    if body is not None:
        headers["Content-Type"] = "application/json"
    req = urllib.request.Request(BASE + target, data=body, method=method, headers=headers)
    try:
        with urllib.request.urlopen(req, timeout=10) as res:
            return res.status, json.load(res)
    except urllib.error.HTTPError as e:
        return e.code, json.load(e)


event = {"type": "registration", "player_id": "PLR-1001", "click_id": "CID_FROM_LANDING_URL"}
print(*call("POST", "/v1/postback", json.dumps(event).encode()))
print(*call("GET", "/v1/reports?by=link&days=7"))

<?php
const KEY = 'pb_your_key_id';
const SECRET = 'your_secret';
const BASE = 'https://app.revrake.com';

// hex HMAC-SHA256 of "<timestamp>.<payload>" under the secret
function sign(string $secret, string $timestamp, string $payload): string
{
    return hash_hmac('sha256', $timestamp . '.' . $payload, $secret);
}

function call(string $method, string $target, ?string $body = null): array
{
    $ts = (string) time();
    // Write: the payload is the body. Read: the path and the query, as sent.
    $payload = $body ?? $target;
    $headers = [
        'X-RevRake-Key: ' . KEY,
        'X-RevRake-Timestamp: ' . $ts,
        'X-RevRake-Signature: ' . sign(SECRET, $ts, $payload),
    ];
    $ch = curl_init(BASE . $target);
    curl_setopt_array($ch, [CURLOPT_CUSTOMREQUEST => $method, CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 10]);
    if ($body !== null) {
        $headers[] = 'Content-Type: application/json';
        curl_setopt($ch, CURLOPT_POSTFIELDS, $body);
    }
    curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
    $answer = curl_exec($ch);
    return [curl_getinfo($ch, CURLINFO_RESPONSE_CODE), json_decode($answer, true)];
}

$event = ['type' => 'registration', 'player_id' => 'PLR-1001', 'click_id' => 'CID_FROM_LANDING_URL'];
print_r(call('POST', '/v1/postback', json_encode($event)));
print_r(call('GET', '/v1/reports?by=link&days=7'));

package main

import (
	"bytes"
	"crypto/hmac"
	"crypto/sha256"
	"encoding/hex"
	"fmt"
	"io"
	"net/http"
	"strconv"
	"time"
)

const (
	key    = "pb_your_key_id"
	secret = "your_secret"
	base   = "https://app.revrake.com"
)

// sign is the hex HMAC-SHA256 of "<timestamp>.<payload>" under the secret.
func sign(secret, timestamp string, payload []byte) string {
	mac := hmac.New(sha256.New, []byte(secret))
	mac.Write([]byte(timestamp + "."))
	mac.Write(payload)
	return hex.EncodeToString(mac.Sum(nil))
}

func call(method, target string, body []byte) (int, string, error) {
	ts := strconv.FormatInt(time.Now().Unix(), 10)
	// Write: the payload is the body. Read: the path and the query, as sent.
	payload := body
	if body == nil {
		payload = []byte(target)
	}
	req, err := http.NewRequest(method, base+target, bytes.NewReader(body))
	if err != nil {
		return 0, "", err
	}
	req.Header.Set("X-RevRake-Key", key)
	req.Header.Set("X-RevRake-Timestamp", ts)
	req.Header.Set("X-RevRake-Signature", sign(secret, ts, payload))
	if body != nil {
		req.Header.Set("Content-Type", "application/json")
	}
	res, err := (&http.Client{Timeout: 10 * time.Second}).Do(req)
	if err != nil {
		return 0, "", err
	}
	defer res.Body.Close()
	answer, err := io.ReadAll(res.Body)
	return res.StatusCode, string(answer), err
}

func main() {
	event := []byte(`{"type":"registration","player_id":"PLR-1001","click_id":"CID_FROM_LANDING_URL"}`)
	fmt.Println(call("POST", "/v1/postback", event))
	fmt.Println(call("GET", "/v1/reports?by=link&days=7", nil))
}

Test vektörü

Bu girdilerle kodunuz tam olarak şu imzaları üretmelidir:

Gizli anahtar

test_secret

Zaman damgası

1791072000

Gövde

{"type":"registration","player_id":"PLR-1001","btag":"1001_1"}

İmza

115d8c73c6069d8953a36ca3a68c114da6232e4ba31889fd519d41ab1350a603

Bir okumanın istek hedefi

/v1/reports?by=link&days=7

Okumanın imzası

ed1ed72dd7ddef22c762f63b8919011e7c36c7214b55b72693c5927fb4b911d0

Sınırlar

Ürünün bugün entegrasyonlara, takibe ve affiliate'lere uyguladığı sınırların tamamı, rakamlarıyla birlikte bunlardır. Giriş, parola sıfırlama ve başvuruların da kötüye kullanıma karşı sınırları vardır.

İki yazma endpoint'i, POST /v1/postback ve POST /v1/files, anahtar başına sınırlıdır (tabloya bakın). Her yanıt X-RateLimit-Limit ve X-RateLimit-Remaining taşır; ret, Retry-After ile birlikte 429 olur. Olaylarınızı geldikleri hızda gönderin, geriye dönük yükleme için toplu gönderim kullanın. Takip linkinin hız sınırı yoktur; bir linke tek adresten gelen olağandışı bir tıklama patlaması fraud işareti oluşturur ve yine de yönlendirilir.

Okumaların hız sınırı

• Her anahtar dakikada 120 okuma yapabilir. Hak, 120'lik bir kovadır: bir okuma kovadan bir hak alır ve her yarım saniyede bir hak geri gelir. Bir süredir kullanılmamış bir anahtar art arda 120 okuma yapabilir; ondan sonra saniyede iki.
• Her okuma yanıtı X-RateLimit-Limit (her zaman 120) ve X-RateLimit-Remaining (şu anda kaç okuma kaldığı) başlıklarını taşır.
• Sınır aşıldığında yanıt, bir Retry-After başlığıyla birlikte 429 rate_limited olur: beklenecek saniye. Bekleyin, sonra aynı isteği yeni bir zaman damgasıyla imzalayarak yeniden gönderin.
• Sınır anahtar başına sayılır: operatörün anahtarının ve her affiliate'in anahtarının kendi hakkı vardır.

HTTP/1.1 200 OK
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 117

HTTP/1.1 429 Too Many Requests
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 0
Retry-After: 1

{"error":"rate_limited","message":"Too many requests: at most 120 reads a minute per key. One more is allowed every half second; wait the seconds in Retry-After and try again."}

Bir 429 yanıtını ele alma

// read(target) signs one GET with a fresh timestamp and sends it,
// as in the signing samples.
async function readWithRetry(target, tries = 5) {
  for (let i = 0; i < tries; i++) {
    const res = await read(target);
    if (res.status !== 429) return res;
    const seconds = Number(res.headers.get('Retry-After')) || 1;
    await new Promise((resolve) => setTimeout(resolve, seconds * 1000));
  }
  throw new Error('still rate limited after ' + tries + ' tries');
}

POST /v1/postback

Operatörün platformundan tek bir olayı bildirir. Gövde, bir type alanı ve o türün alanlarını taşıyan bir JSON nesnesi ya da bu tür nesnelerden oluşan bir JSON dizisidir (toplu gönderim).

POST https://app.revrake.com/v1/postback

• type şunlardan biridir: registration, deposit, chargeback, ngr.
• Tür için listelenmeyen bir alan 422 ile reddedilir; böylece bir yazım hatası asla sessizce yok sayılmaz.
• ts, olayın RFC 3339 biçimindeki zamanıdır (2026-10-04T08:15:00Z). Verilmezse isteğin zamanı kullanılır. Bir UTC farkı taşımalıdır (Z veya +03:00); UTC farkı olmayan bir zaman reddedilir. Bir günden fazla gelecekte olamaz.
• Tutar, JSON metni veya JSON sayısı olarak bir ondalık değerdir: "25.00" veya 25.5. Binlik ayırıcı ve üs kullanılmaz; ondalık basamak sayısı para birimininkini aşamaz.
• currency üç harfli bir ISO 4217 kodudur. Küçük harf kabul edilir. Verilmezse çalışma alanının raporlama para birimi kullanılır.
• Metin değerlerinin başındaki ve sonundaki boşluklar kırpılır; click_id ve btag hariç: bunları landing sayfasına geldikleri haliyle aynen gönderin.

registration

Yeni bir oyuncu. click_id, btag, promo_code veya bunlardan birkaçını gönderin; hiçbiri yoksa oyuncu atfedilmemiş olarak kaydedilir. Oyuncu bir kez, burada atfedilir. Yanıt: attribution.

{"type":"registration","player_id":"PLR-1001","click_id":"01K6QF3M8Z5T7W9XB2C4D6E8GH","btag":"1001_1"}

{
  "status": "accepted",
  "event_type": "registration",
  "event_id": "0199b2c4-6f1e-7a53-9d0c-2b8f4e1a7c33",
  "attribution": {
    "attributed": true,
    "reason": "click",
    "affiliate_number": 1001,
    "link_number": 1,
    "click_id": "01K6QF3M8Z5T7W9XB2C4D6E8GH",
    "policy_version": 1,
    "window_days": 30,
    "model": "last_click"
  }
}

deposit

Her para yatırma işlemi için işlem kimliğinizi txn_id alanında taşıyan bir deposit olayı gönderin. Anlaşma, CPA eşiğini ilk yatırımla mı yoksa chargeback tutarları düşülmüş toplam yatırımla mı karşılaştıracağını belirler. Koşul sağlandığında oyuncu başına bir CPA komisyonu beklemede oluşturulur.

{"type":"deposit","player_id":"PLR-1001","txn_id":"TX-88213","amount":"25.00","currency":"KES","first":true}

{
  "status": "accepted",
  "event_type": "deposit",
  "event_id": "0199b2c9-03aa-7e10-b6d2-91c07f5e2a18",
  "commission": {
    "effect": "created",
    "type": "cpa",
    "amount_minor": 4000,
    "status": "hold"
  }
}

chargeback

Kendi txn_id değeriyle bir chargeback olayı gönderin; asıl yatırımın txn_id değerini ref_txn_id alanına yazın. Bu, yatırımın tamamını geri alır. Toplam yatırıma dayalı CPA’da komisyon yalnızca kalan uygun toplam eşiğin altına düşerse geri alınır: bekleyen komisyon iptal edilir; onaylanmış veya ödenmiş komisyon için iade satırı eklenir.

{"type":"chargeback","txn_id":"CB-5001","ref_txn_id":"TX-88213"}

{
  "status": "accepted",
  "event_type": "chargeback",
  "event_id": "0199cc10-7b2d-7c41-a3f0-5d2e8b9c1f47",
  "commission": {
    "effect": "cancelled",
    "type": "cpa",
    "amount_minor": 4000,
    "status": "rejected"
  }
}

ngr

Bir oyuncunun bir güne veya bir aya ait net oyun geliri (NGR). Dönemin sonunda yürürlükte olan anlaşma sürümündeki RevShare'i beklemede olarak kazandırır. Oyuncu kayıtlı olmalıdır. Yanıt: commission.

{"type":"ngr","player_id":"PLR-1001","period":"2026-10-03","amount":"118.40","currency":"KES"}

{
  "status": "accepted",
  "event_type": "ngr",
  "event_id": "0199b2d1-5c0e-7b42-8a17-3e9d6f0c4b21",
  "commission": {
    "effect": "created",
    "type": "revshare",
    "amount_minor": 2960,
    "status": "hold"
  }
}

Yanıt

Kaydedilen veya zaten kayıtlı olan bir olay 200 ve bir JSON nesnesiyle yanıtlanır. Geçerli olmayan alanlar yanıtta yer almaz.

{
  "status": "accepted",
  "event_type": "deposit",
  "event_id": "0199b2c9-03aa-7e10-b6d2-91c07f5e2a18",
  "waiting_for_player": true
}

{
  "status": "duplicate",
  "event_type": "deposit",
  "event_id": "0199b31f-8c02-7a66-b4e1-2d7f9a3c6e15",
  "duplicate_of": "0199b2c9-03aa-7e10-b6d2-91c07f5e2a18",
  "detail": "The same deposit (TX-88213) was already reported through the API; this one adds nothing."
}

{
  "status": "duplicate",
  "event_type": "deposit",
  "event_id": "0199b2ca-11d4-7f09-8c55-0a6e2d4b7f90",
  "commission": { "effect": "none", "reason": "not_first" }
}

Bir komisyon hold durumuyla oluşturulur. Anlaşmanın bekletme süresi dolduğunda otomatik olarak onaylanır; onu hâlâ bekleten bir şey varsa onaylanmaz: açık bir fraud işareti, onaylı olmayan bir affiliate veya eksik bir kur.

Atıf nedenleri

Önce click ID denenir. Sizinkilerden biri değilse btag denenir. Kural btag'in kazandığını söylüyorsa ve btag bir linkle eşleşiyorsa, bunun yerine önce btag denenir. Bir linkle eşleşen btag, tıklama bulunamasa bile oyuncuyu atfeder. Promosyon kodu en son, yalnızca ne click ID ne de btag oyuncuyu atfetmediğinde denenir. Kural, penceresi ve ikisinden hangisinin kazandığı Entegrasyon sayfasında belirlenir; her değişiklik yeni bir sürümdür. Politika promosyon kodunun geçerli olduğunu söylediğinde, bir bağlantıyla eşleşen kod ikisinden önce denenir; eşleşmeyen kod onlara geri döner. Bir anlaşma kendi penceresini belirleyebilir; bu, ortaklarının bağlantılarındaki tıklamalar için politikanın penceresinin yerini alır.

Neden komisyon oluşturulmadı

Toplu gönderim

Gövde, aynı endpoint'e aynı başlıklarla gönderilen, 1 ile 1.000 arasında olaydan oluşan bir JSON dizisi olabilir. İmza dizinin tamamını kapsar. Olaylar sırayla ve her biri ayrı işlenir; böylece reddedilen bir olay diğerlerini asla durdurmaz.

Okunabilen bir toplu istek, içindeki her olay reddedilmiş olsa bile 200 ile yanıtlanır. Sayılara bakın.

[
  {"type":"deposit","player_id":"PLR-1001","txn_id":"TX-88213","amount":"25.00","first":true},
  {"type":"ngr","player_id":"PLR-1001","period":"2026-10-03","amount":"118.40"},
  {"type":"ngr","player_id":"PLR-1002","period":"October","amount":"-12.50"}
]

{
  "results": [
    {
      "index": 0,
      "status": "accepted",
      "event_type": "deposit",
      "event_id": "0199b2c9-03aa-7e10-b6d2-91c07f5e2a18",
      "commission": { "effect": "created", "type": "cpa", "amount_minor": 4000, "status": "hold" }
    },
    {
      "index": 1,
      "status": "duplicate",
      "event_type": "ngr",
      "event_id": "0199b2d1-5c0e-7b42-8a17-3e9d6f0c4b21",
      "commission": { "effect": "created", "type": "revshare", "amount_minor": 2960, "status": "hold" }
    },
    {
      "index": 2,
      "status": "rejected",
      "field": "period",
      "message": "period must be a day (2026-10-03) or a month (2026-10), not in the future."
    }
  ],
  "accepted": 1,
  "duplicate": 1,
  "rejected": 1
}

POST /v1/files

Entegrasyon sayfasından yüklemeye ya da RevRake'in dosyayı platformunuzun yayımladığı bir adresten almasına alternatif olarak günlük bir CSV dosyası gönderir. Gövde dosyanın kendisidir; başlıklar ve imza bir olaydakilerle aynıdır ve imza zaman damgasını ve dosyayı kapsar. Dosya adı filename sorgu parametresinde verilir; portalda gösterilir, başka bir amaçla kullanılmaz.

POST https://app.revrake.com/v1/files?filename=sales-2026-10-03.csv

Hangi dosya olduğuna başlık satırı karar verir: registration_date sütunu olan dosya bir REG dosyasıdır, activitydate sütunu olan dosya bir SALES dosyasıdır. Sütun adları büyük/küçük harf ayrımı yapılmadan eşleştirilir. Aşağıda listelenmeyen sütunlar dosyada kalabilir; yok sayılırlar.

Kabul edilen biçimler: YYYY-MM-DD, YYYY-MM-DD HH:MM:SS, YYYY-MM-DDTHH:MM:SS, RFC 3339 veya YYYY/MM/DD. UTC ofseti yoksa çalışma alanı Ayarlar bölümündeki dosya saat dilimi kullanılır (varsayılan UTC). Ofsetli zaman damgası kesin bir anı belirtir; SALES için bu anın dosya saat dilimindeki takvim günü kullanılır. Gün ve ay tahmin edilmez: 30/09/2026 reddedilir.

REG dosyası: kayıtlı oyuncu başına bir satır

brand_name,registration_date,btag,promo_code,player_id,player_country
Example,2026-10-03,1001_1,,PLR-1001,KE
Example,2026-10-03,,,PLR-1002,KE
Example,2026-10-03,,GARAGE50,PLR-1003,KE

SALES dosyası: oyuncu ve gün başına bir satır

brand_name,activitydate,player_id,btag,currency,deposits,first_deposit_amount,chargeback,casino_net_revenue,sports_net_revenue
Example,2026-10-03,PLR-1001,1001_1,KES,3500.00,2500.00,0,118.40,0
Example,2026-10-03,PLR-1002,,KES,900.00,0,0,-12.50,

• Her SALES satırı bir günlük para özeti ve gelir hücreleri doluysa ayrı bir NGR olayı kaydeder. Bağımsız işlenirler: para özetinin reddedilmesi kabul edilmiş geliri geri almaz; tersi de geçerlidir. Yanıttaki tüm sorunları kontrol edin.
• Marka, oyuncu ve etkinlik günü başına bir özet vardır; ilk kabul edilen para birimi sabitlenir. Dosya yeniden adlandırılsa veya sıralansa da aynı parasal değerler tekrar olarak işlenir. Kabul edilmiş bir günün tutarlarını, para birimini veya saat dilimi sınırlarını değiştirmek, sıfırdan yapılan değişiklikler dahil, çakışmadır. Önceden kaydedilmiş tutarlar değişmez.
• deposits, first_deposit_amount ve chargeback zorunlu sütunlardır. Boş hücreler sıfırdır. Tutarlar negatif olmayan, satırın para birimi hassasiyetine uygun ondalık sayılar olmalıdır. Dışa aktarımı bağlamadan önce bu tanımları platformunuzla doğrulayın.
• REG dosyasını SALES’ten önce gönderin. Önce gelen para özetleri saklanır ve kayıt geldiğinde hesaplanır. Bilinmeyen oyuncunun NGR verisi reddedilir: REG sonrasında SALES veya NGR’yi tekrar gönderin. Saklanan para özeti tekrar olarak işlenir.
• Özet, dosya saat dilimindeki etkinlik günü ve para biriminin tekil postback’lerini kapsar; tutarlar iki kez eklenmez. İşlem kimlikleri referans olarak kullanılabilir kalır. Bilinen yatırım veya chargeback tutarlarının özeti aşması ya da ilk yatırıma ilişkin çelişkili kanıtlar çakışma oluşturur.
• Toplam yatırıma dayalı CPA’da yatırımlar eksi chargeback tutarları anlaşma eşiğine ulaşmalıdır. Her günlük nakit akışı etkinlik tarihinin kurunu, tekil postback’ler ise kendi UTC gününün kurunu kullanır. Eksik kurlar hesaplamayı fx_rate_missing ile bekletir. Eksik chargeback kuru, ödemeye dahil edilmiş komisyonlar da dahil, mutabakata kadar chargeback_fx_missing ile ödemeyi engeller.
• İlk yatırıma dayalı CPA’da toplam chargeback hangi yatırımın geri alındığını göstermeyebilir. Kayıtlı oyuncunun belirsiz para özeti reddedilir. Özet REG’den önce geldiyse saklanır ve kayıt kabul edilir, ancak oluşan CPA chargeback_reference_missing ile beklemede kalır. İşlem referansının incelenmesi için ref_txn_id alanına asıl yatırımın işlem kimliğini yazarak chargeback gönderin.
• Gelir, değiştirilemeyen parasal toplamlardan ayrıdır: günlük NGR tutarı değişirse düzeltme bildirimi sayılır ve komisyon farkı bir düzeltme olarak eklenir.

Yanıt

Okunabilir dosya 200 döndürür. Sayaçlar yalnızca satır değil olay bazındadır: bir SALES satırı para özeti ve NGR’yi ayrı kaydedebilir, kısmi başarı da mümkündür. Her zaman rejected ve problems alanlarını kontrol edin.

{
  "id": "0199b31e-2a40-7d18-9b6c-4f1e7a2c5d03",
  "filename": "sales-2026-10-03.csv",
  "kind": "sales",
  "uploaded_at": "2026-10-04T02:00:07Z",
  "rows_total": 2,
  "accepted": 3,
  "duplicates": 0,
  "rejected": 1,
  "skipped": 0,
  "problems": ["line 3: Player PLR-1002 is not registered. Send the registration first."]
}

GET /v1/reports

Raporlar sayfasındaki raporu verir: tıklamalar, işaretlenen tıklamalar, kayıtlar, ilk yatırımlar ve kazanç; tek bir ölçüte göre gruplanmış olarak, çalışma alanının saat dilimine göre bugüne kadarki günler için. Bugünün rakamları bir rapor istendiğinde yenilenir; yoğun bir programda en fazla 30 saniyede bir.

GET https://app.revrake.com/v1/reports?by=link&days=7

{
  "by": "link",
  "from": "2026-09-28",
  "to": "2026-10-04",
  "currency": "KES",
  "rows": [
    {
      "key": "0199a7f0-41c2-7e55-b1d9-6c3a8e2f7b10",
      "label": "telegram-october",
      "clicks": 1840,
      "flagged_clicks": 212,
      "registrations": 96,
      "ftds": 31,
      "earnings_minor": 12400000
    }
  ],
  "total": {
    "key": "",
    "label": "",
    "clicks": 1840,
    "flagged_clicks": 212,
    "registrations": 96,
    "ftds": 31,
    "earnings_minor": 12400000
  }
}

CSV olarak

format=csv ile yanıt bir dosyadır. İlk sütunu gruplamanın adını taşır ve etiketi içerir; ardından clicks, flagged_clicks, registrations, first_deposits ve ondalık olarak earnings_<currency> gelir. Son satır toplamdır.

link,clicks,flagged_clicks,registrations,first_deposits,earnings_KES
telegram-october,1840,212,96,31,124000.00
total,1840,212,96,31,124000.00

GET /v1/commissions

Komisyon defterinin bir sayfasını verir; başka türlü sıralamadıysanız en yeni en üstte. Satırların tutarları asla düzenlenmez ve satırlar asla silinmez, ancak bir satırın status değeri yazıldıktan sonra değişir: hold, sonra approved, sonra paid ya da rejected. Bir senkronizasyon yalnızca yeni satırları almamalı, bir dönemi yeniden okuyup satırları id değerine göre güncellemelidir.

GET https://app.revrake.com/v1/commissions?from=2026-09-01&to=2026-10-01&per_page=500

{
  "currency": "KES",
  "totals": { "hold": 1240000, "approved": 3720000, "paid": 9800000 },
  "owed": { "KES": { "hold": 1240000, "approved": 3720000, "paid": 9800000 } },
  "period": true,
  "commissions": [
    {
      "id": "0199b2c9-0a11-7c3e-9f20-7d4b1e6a2c58",
      "occurred_at": "2026-09-14T08:20:00Z",
      "type": "cpa",
      "currency": "KES",
      "gross_currency": "KES",
      "reporting_minor": 400000,
      "affiliate_name": "Odds Garage",
      "affiliate_number": 1001,
      "player_ref": "PLR-1001",
      "deal_name": "CPA 4000",
      "deal_version": 2,
      "gross_minor": 250000,
      "rate_snapshot": 400000,
      "amount_minor": 400000,
      "status": "approved",
      "status_reason": "",
      "hold_until": "2026-10-14T08:20:00Z",
      "status_note": ""
    }
  ],
  "total": 1,
  "page": 1,
  "per_page": 500
}

Bir komisyon satırı

Program listeleri: ortaklar, bağlantılar, anlaşmalar

Arka ucunuz programı portalın gösterdiği gibi listeleyebilir; diğer okumalar gibi imzalanır ve aynı sınıra sayılır. GET /v1/affiliates ve GET /v1/deals operatör anahtarı ister; ortak anahtarıyla 403 operator_key_required döner. GET /v1/links markanın bağlantılarını ya da affiliate=<numara> ile bir ortağınkileri döner; ortak anahtarıyla yalnızca o ortağınkileri.

Listeler page (1'den başlar) ve per_page (1–500, varsayılan 100) ile sayfalanır ve total içerir. GET /v1/affiliates ayrıca status alır: pending, approved, rejected veya suspended. API üzerinden ortak veya bağlantı oluşturma henüz sunulmuyor: ne için kullanacağınızı bize yazın.

GET https://app.revrake.com/v1/links?affiliate=1001&per_page=100

Her ortak

Her bağlantı

Her anlaşma

Veri ambarı aktarımı

Entegrasyon sayfasında ayarlanır: RevRake her gece her markanın bir önceki gününü S3 uyumlu herhangi bir hizmetteki kendi kovanıza, <klasör>/<marka>/<YYYY-AA-GG>/ yoluna yazar; gün, çalışma alanının saat diliminde sayılır. gzip ile sıkıştırılmış dört CSV dosyası (UTF-8, başlık satırı, RFC 4180 tırnaklama), ardından manifest.json. Manifest en son yazılır: bir günü manifest oluştuğunda yükleyin ve her dosyanın rows, bytes ve sha256 değerlerini karşılaştırın.

Bir satır geldiği güne aittir (tıklama: yapıldığı an), bu yüzden geç gelen günlük dosya geldiği günde yer alır, asla kaybolmaz. Zamanlar milisaniyeli UTC, RFC 3339; tutarlar kendi para biriminde ondalık. Durumlar aktarım anındakidir: bir komisyonun durumu sonra değişir, güncel durum için GET /v1/commissions'ı yeniden okuyun. Başarısız bir gün her saat yeniden denenir ve yedi güne kadar geriye telafi edilir; bir günü yeniden aktarmak dosyalarının üzerine yazar. Dosyanın sonuna yeni sütunlar eklenebilir; bir yükleyicinin değişmesi gerektiğinde manifestteki schema_version değişir.

manifest.json: schema_version, workspace, brand, day, timezone, from ve to (günün UTC sınırları), generated_at ve files: her biri için name, rows, bytes, sha256 (sıkıştırılmış dosyanın).

clicks.csv.gz: o gün markanın bağlantılarındaki tüm tıklamalar, işaretlenenler dahil.

players.csv.gz: kaydı o gün gelen oyuncular.

events.csv.gz: günlük SALES özetleri dahil o gün gelen, markanın kabul edilmiş tüm olayları ve içerikleri.

commissions.csv.gz: o gün yazılan komisyon satırları.

Idempotency (tekrarın zararsızlığı)

Her olayın doğal bir anahtarı vardır. Aynı içeriğin tekrarı kayıtlı yanıtı "status":"duplicate" ile döndürür. Kayıt bekleyen yatırımın yanıtı kayıt geldiğinde güncellenir. Değişen parasal bilgiler çakışabilir; NGR düzeltmeleri revizyon kullanır. Zaman aşımından sonra yeni imza zaman damgasıyla tekrar deneyin.

Durumlar ve hatalar

API'nin verebileceği her yanıt ve bir kaydın alabileceği her durum, tek bir yerde. Bir hata bir JSON nesnesiyle yanıtlanır: error (kod), message (İngilizce bir cümle) ve invalid için field.

{"error":"invalid","field":"amount","message":"amount must be a positive decimal in KES, for example 25.00."}

HTTP durumları ve hata kodları

• Hiç olay içermeyen ya da 1.000'den fazla olay içeren bir toplu istek 422 invalid ile ve field olmadan reddedilir.
• Operatör anahtarıyla gelen hatalı bir zaman damgası veya imza için dönen 401, gelen günlüğünde bad_signature olarak listelenir. Bilinmeyen bir anahtarla veya bir affiliate anahtarıyla gelen istek günlüğe yazılmaz.
• Bir okuma yalnızca kullanılamayan bir rapor dönemi için (from ve to) 422 ile yanıtlanır. İzin verilmeyen bir değere sahip diğer her parametre yok sayılır ve varsayılanı kullanılır. Yanıttaki by, page ve per_page değerlerini kontrol edin.
• Zaman aşımında, 429 ve 500 yanıtlarında yeniden deneyin. Başka bir 4xx yanıtını değiştirmeden yeniden denemeyin.

Bir 422 yanıtında field neyi belirtir

Bir olayın durumu

Tek bir olayın yanıtında ve bir toplu isteğin results alanında olay başına yer alır.

Bir olayın defterdeki etkisi

Komisyon türleri

Komisyon durumları

Bir satır bir kez yazılır ve tutarları asla değişmez. Durumu değişir:

status_reason değerleri

Satır yalnızca bekletme süresini bekliyorsa ve normalde onaylanmış veya ödenmiş komisyonlarda boştur. Eksik chargeback kuru onaylanmış satırı da engelleyebilir. Dolandırıcılık bekletmeleri operatörü veya ayarlanmış işaret süresinin dolmasını bekler.

Ödeme durumları

Bir ay, affiliate ve para birimi başına bir kalem içeren bir ödeme paketine kapanır. Paketler ve kalemler portalda işlenir; API bunların sonucunu komisyon satırlarının paid durumu olarak gösterir.

Bir dosya satırı neden reddedilir

Reddedilen bir satır rejected içinde sayılır, problems içinde line N: reason biçiminde listelenir ve satırın kendisiyle birlikte gelen günlüğünde saklanır. Bir olayın reddedilebileceği nedenlere ek olarak:

• Satır geçerli CSV değildir.
• REG: registration_date veya player_id eksik ya da okunamıyor.
• SALES: activitydate veya player_id eksik ya da okunamıyor.
• SALES, gelir: oyuncu kayıtlı değil.
• SALES, para: tutar negatif, okunamıyor veya para birimine göre çok fazla ondalık basamak içeriyor.
• SALES: ilk yatırım brüt yatırımları aşıyor.
• SALES: kabul edilen gün değişen parasal toplamlarla, para birimiyle veya saat dilimi sınırlarıyla yeniden dışa aktarılmış.
• SALES: bilinen tekil yatırımlar veya chargeback işlemleri günlük özeti aşıyor.
• SALES: ilk yatırım kanıtı başka bir günle veya bilinen işlemle çelişiyor.
• SALES: kayıtlı oyuncunun ilk yatırıma dayalı CPA’sı için toplam chargeback belirsizdir.

Gelen günlüğündeki sonuçlar

Bir postback teslimatının durumları

Bir affiliate'in durumları

Takip linki

Bir takip linkini platformunuz çağırmaz, bir ziyaretçi açar. Link tıklamayı kaydeder ve markanın landing sayfasına bir 302 yönlendirmesiyle yanıt verir. Marka sitesini doğrulayana kadar ziyaretçi önce linkin nereye gittiğini söyleyen kısa bir sayfa görür. Hedef host marka ayarlarından gelir; bir link yalnızca onun üzerinde bir yol seçebilir.

GET https://track.revrake.com/c/a8Kq2Zx?sub1=TRACKER_CLICK_ID&utm_source=telegram

HTTP/1.1 302 Found
Location: https://your-site.example/landing?btag=1001_1&cid=01K6QF3M8Z5T7W9XB2C4D6E8GH&utm_source=telegram
Cache-Control: no-store

Linkteki parametreler

Landing URL'sine eklenen parametreler

• Markanın landing URL'si sorgusunda {click_id} içeriyorsa click ID oraya yazılır ve cid eklenmez.
• Onaylı olmayan bir affiliate'in linkine yapılan tıklama kaydedilir ve işaretlenir; ziyaretçi cid ve btag olmadan yönlendirilir: tıklama atfedilemez.
• Botlar, link önizlemeleri, HEAD istekleri, user agent taşımayan istekler ve bir saat içindeki tekrar tıklamalar kaydedilir ve işaretlenir, atılmaz. Raporlar bunları dışarıda bırakır.
• Linkteki diğer parametreler saklanmaz ve aktarılmaz.
• Affiliate'in kısa bir ad verdiği bir link /go/<name> adresinde de, /c/<code> adresindekiyle tamamen aynı şekilde yanıt verir. Kendi doğrulanmış takip alan adı olan bir marka, iki yolu o alan adında da sunar.
• Bilinmeyen bir kod 404 ve bir HTML hata sayfasıyla yanıtlanır; markası henüz bir hedef belirlememiş bir link de öyle.

Affiliate tracker'larına postback

Bu kısım operatörden iş gerektirmez. Her affiliate portalında en fazla 10 hedef ekler: makrolu bir adres şablonu ve haberdar edilmek istediği olaylar. Affiliate'in oyuncularından biri için bir olay kaydedildiğinde RevRake şablonu doldurur ve bir GET isteğiyle çağırır.

Olaylar

Ön ayara göre durum sözcükleri

Bir ön ayardan oluşturulan hedef, {status} içinde tracker'ının tanıdığı sözcükleri gönderir. Voluum, PeerClick ve FunnelFlux Pro ön ayarları ile "Diğer / özel", yukarıdaki tablodaki sözcükleri gönderir. Sözcükler, hedefin taşıdığı ön ayarı izler; hedefin kayıtlı adresi asla değiştirilmez.

Makrolar

Makro, süslü parantez içinde bir addır. URL kodlanmış değeriyle değiştirilir. Adlar büyük/küçük harf ayrımı yapılmadan eşleştirilir. RevRake'in tanımadığı bir ad olduğu gibi gönderilir; böylece bir yazım hatası teslimat günlüğünde görünür. Bilinmeyen bir değer boş gönderilir.

Aynı makroların diğer adları

Tracker'lar aynı şeyler için farklı adlar kullanır. Şunlar da kabul edilir:

Ön ayarlar

Affiliate portalında şu şablonlar hazır gelir. Affiliate sunucu adını kendi tracker'ınınkiyle değiştirir. Her şablon kendi tracker'ının dokümantasyonunu izler: tracker'ın aynı ID ile yeniden gelen bir dönüşümü güncellediği yerde işlem parametresinde {conversion_id}, sonraki olayları atacağı yerde {event_id} bulunur.

Bir örnek

https://YOUR-TRACKER-DOMAIN/postback?click_id={sub1}&event={event}&status={status}&payout={commission}&currency={currency}&tid={conversion_id}&eid={event_id}

GET https://tracker.example/postback?click_id=TRACKER_CLICK_ID&event=ftd&status=sale&payout=40.00&currency=KES&tid=0199b2c9-0a11-7c3e-9f20-7d4b1e6a2c58&eid=0199b2c9-03aa-7e10-b6d2-91c07f5e2a18%3Aftd

Teslimat

• Bir postback, bildirdiği olayla aynı veritabanı işleminde kuyruğa alınır ve yaklaşık on saniye içinde, en eskisi önce olacak şekilde gönderilir.
• İstek, user agent değeri RevRake-Postback/1 olan bir GET isteğidir. En fazla üç yönlendirmeyi izler ve 5 saniye sonra vazgeçer. Sertifikalar doğrulanır.
• Bir 2xx yanıtı başarıdır. Bunun dışındaki her şey başarısızlıktır ve 1 dakika, 5 dakika, 25 dakika, 2 saat, 10 saat ve 24 saat sonra yeniden denenir.
• Son yeniden denemeden sonra teslimat vazgeçildi olarak işaretlenir. Affiliate onu elle yeniden gönderebilir.
• Her deneme süresi, durumu ve yanıtın ilk 500 karakteriyle kaydedilir.
• Art arda 5 ve 15 başarısızlıktan sonra hedefin sahibi bir e-posta alır. 20'de hedef kapatılır. Teslimatları, hedef kapalıyken gerçekleşen olayların teslimatları dahil, kuyruğa girmeye devam eder ve affiliate hedefi yeniden açtığında gönderilir. Affiliate'in kendisinin kapattığı bir hedefe yeni bir şey gönderilmez.
• RevRake yalnızca herkese açık adresleri çağırır. Loopback, özel, link-local ve carrier-grade NAT adresleri bağlantı kurulurken reddedilir; böylece bir yönlendirme bu kuralı aşamaz.
• Şablon, en fazla 2.000 karakterlik tam bir http:// veya https:// adresi olmalıdır.

Bir deneme neden başarısız oldu

Operatör webhook'ları

Webhook'lar, programda olanları operatörün kendi sistemlerine (bir CRM, bir veri ambarı, bir sohbet kanalı) bildirir. Bir çalışma alanı yöneticisi, operatör portalının Entegrasyon sayfasında bir endpoint ekler: sunucunuzdaki adres, gönderilecek olaylar ve isteğe bağlı bir açıklama. Bu olayların her biri için RevRake adrese imzalı bir JSON POST isteği gönderir. Diğer ekip üyeleri endpoint'leri göremez ve değiştiremez.

Adres, herkese açık bir sunucuda tam bir https:// adresidir (http:// kabul edilir, ancak https:// kullanın). Her endpoint'in whsec_ ile başlayan kendi gizli anahtarı vardır. Endpoint oluşturulduğunda veya gizli anahtarı yenilendiğinde yalnızca bir kez gösterilir: o anda kopyalayın. Yenileme hemen yeni bir gizli anahtar oluşturur ve eskisi imzalamayı bırakır.

Bir uç nokta Slack veya Microsoft Teams kanalı da olabilir: “Slack mesajı” veya “Microsoft Teams mesajı”nı seçin ve kanalın gelen webhook adresini yapıştırın (Teams için “Bir Teams webhook isteği alındığında” iş akışı). Her olay imzalı JSON yerine kanala bir cümle olarak gelir; bir tutar yalnızca o büyüklükten itibaren ilk yatırımları bırakabilir.

Olaylar

Her endpoint için bir veya daha fazlasını işaretleyin. data alanları aşağıda açıklanmıştır; geçerli olmayan bir alan gönderilmez.

Gövde

Her istek tek bir JSON nesnesi taşır:

{
  "id": "0199b2c9-0a11-7c3e-9f20-7d4b1e6a2c58",
  "type": "commission.created",
  "created_at": "2026-10-05T09:12:44.318204Z",
  "data": {
    "player_id": "PLR-1001",
    "occurred_at": "2026-10-05T09:12:40Z",
    "attributed": true,
    "affiliate_number": 1001,
    "affiliate_name": "Odds Garage",
    "commission_id": "0199b2c9-0a0f-7a51-8c3d-5e2f4a6b7c90",
    "commission_type": "cpa",
    "amount": "25.00",
    "amount_currency": "USD",
    "commission": "40.00",
    "commission_currency": "USD"
  }
}

Anahtarlar herhangi bir sırada gelebilir ve JSON'un boşlukları sabit değildir. Baytları alındığı haliyle doğrulayın, sonra ayrıştırın.

Başlıklar

İstek ayrıca Content-Type: application/json başlığını ve RevRake-Webhook/1 kullanıcı aracısını taşır.

POST /revrake-webhook HTTP/1.1
Host: example.com
Content-Type: application/json
User-Agent: RevRake-Webhook/1
RevRake-Event: commission.created
RevRake-Delivery: 0199b2c9-0b7e-7d02-8a41-3c5e6f708192
RevRake-Timestamp: 1791191571
RevRake-Signature: <hex HMAC-SHA256 of "1791191571.<raw body>">

data alanları

Bir isteği doğrulayın

1. Ham gövdeyi, herhangi bir JSON ayrıştırmasından önce bayt olarak okuyun.
2. RevRake-Timestamp değerinin saatinizden en fazla 5 dakika farklı olduğunu kontrol edin, değilse isteği reddedin; böylece kaydedilmiş bir istek daha sonra yeniden oynatılamaz.
3. Zaman damgası, bir nokta ve ham gövdenin endpoint'in gizli anahtarıyla hex HMAC-SHA256 değerini hesaplayın ve sabit sürede RevRake-Signature ile karşılaştırın.
4. Gövdeyi ancak ondan sonra ayrıştırın. id değerini daha önce işlediyseniz 2xx ile yanıt verin ve hiçbir şey yapmayın.
5. 5 saniye içinde herhangi bir 2xx ile yanıt verin ve yavaş işleri sonra yapın.

Entegrasyon sayfasının gösterdiği haliyle, Node.js ve Python'da aynı kontrol:

const crypto = require("node:crypto");

// raw: the body exactly as received (a Buffer), before parsing it as JSON.
function verify(raw, headers, secret) {
  const ts = headers["revrake-timestamp"] ?? "";
  if (!/^\d+$/.test(ts) || Math.abs(Date.now() / 1000 - Number(ts)) > 300) return false;
  const expected = crypto.createHmac("sha256", secret).update(ts + ".").update(raw).digest();
  const got = Buffer.from(headers["revrake-signature"] ?? "", "hex");
  return got.length === expected.length && crypto.timingSafeEqual(got, expected);
}

import hashlib, hmac, time

# raw: the body exactly as received (bytes), before parsing it as JSON.
def verify(raw: bytes, headers, secret: str) -> bool:
    ts = headers.get("RevRake-Timestamp", "")
    if not ts.isdigit() or abs(time.time() - int(ts)) > 300:
        return False
    expected = hmac.new(secret.encode(), ts.encode() + b"." + raw, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, headers.get("RevRake-Signature", ""))

Teslimat, yeniden denemeler ve kapatma

• Bir teslimat, bildirdiği değişiklikle aynı işlemde (transaction) sıraya alınır; bu yüzden bir olay yalnızca ve yalnızca değişiklik kaydedildiyse gönderilir. Yaklaşık on saniye içinde, en eskiden başlayarak gönderilir.
• Teslimat en az bir kezdir: aynı olay birden çok kez gelebilir, örneğin yanıtınız yolda kaybolduğunda. Tekrarları gövdenin id alanına göre ayıklayın.
• Sıra garanti edilmez: bir yeniden deneme, daha sonraki bir olaydan sonra gelebilir. Olayları geliş zamanına göre değil, created_at veya occurred_at değerine göre sıralayın.
• 5 saniye içinde bir 2xx yanıtı başarıdır. Diğer her şey başarısızlıktır ve aynı gövdeyle, yeni bir zaman damgası ve imzayla 1 dakika, 5 dakika, 25 dakika, 2 saat, 10 saat ve 24 saat sonra yeniden denenir.
• Son yeniden denemeden sonra teslimat vazgeçildi olarak işaretlenir. Bir yönetici onu teslimat günlüğünden yeniden gönderebilir; o zaman yeniden denemelerin tamamını yeniden alır.
• Art arda 20 başarısız denemeden sonra endpoint kapatılır. Olayları sıraya girmeye devam eder ve bir yönetici onu yeniden açtığında sıraya giren her şey gönderilir. Bu olduğunda e-posta gönderilmez: her endpoint'in durumu Entegrasyon sayfasındadır.
• Kendiniz kapattığınız bir endpoint yeni bir şey almaz: kapalıyken onun için hiçbir olay sıraya alınmaz.
• RevRake yalnızca herkese açık adresleri çağırır: 5 saniye sonra vazgeçer ve sertifikaları doğrular. Loopback, özel, link-local ve carrier-grade NAT adresleri reddedilir. Yönlendirmeler izlenmez: bir 3xx yanıtı redirect hatasıyla başarısızlıktır ve teslimat günlüğü yönlendirilen adresi gösterir.

Test edin ve teslimat günlüğünü okuyun

• Bir endpoint'te "Test gönder" düğmesine basın: gerçek bir olay gibi imzalanmış bir webhook.test olayı hemen gönderilir ve endpoint'inizin hangi durumla yanıt verdiğini ve ne kadar sürdüğünü görürsünüz. Bir test yeniden denenmez, teslimat günlüğünde listelenmez ve başarısızlık olarak sayılmaz.
• Bir endpoint'in teslimat günlüğü en son 100 teslimatını gösterir: olay, durum (bekliyor, yeniden deneniyor, vazgeçildi veya gönderildi), deneme sayısı, son durum veya hata, yanıtınızın ilk 500 karakteri, bir sonraki deneme ve gönderildiği haliyle gövde.
• Başarısız bir deneme, bir postback ile aynı kelimelerle açıklanır (bir deneme neden başarısız oldu bölümüne bakın), buna ek olarak redirect: endpoint'iniz bir 3xx ile yanıt verdi. Durumlar bir postback teslimatının durumlarıdır.

{
  "id": "0199b2d4-5c60-7b1a-9e3f-1a2b3c4d5e6f",
  "type": "webhook.test",
  "created_at": "2026-10-05T09:30:02.104377Z",
  "data": {
    "message": "A test from RevRake. If you can read this, your endpoint works."
  }
}

İyi uygulamalar

• Gizli anahtarı sunucunuzda tutun, asla bir sayfada veya uygulamada değil. Sızarsa yenileyin ve endpoint'inizi hemen yenisine geçirin: eski gizli anahtar anında durur.
• İmzası eşleşmeyen bir isteğe 4xx ile yanıt verin. Geçerli gizli anahtarla imzalanarak yeniden denenir; böylece siz anahtarı yenilerken yapılan bir teslimat kaybolmaz.
• İşlediğiniz her olayın id değerini saklayın ve gördüğünüz bir olayı yok sayın.
• Önce yanıt verin, sonra çalışın: olayı kendi kuyruğunuza koyun ve 2xx ile yanıt verin; böylece yavaş bir veritabanı RevRake'in yeniden denemesine asla yol açmaz.
• Endpoint'inizin son adresini girin. Yönlendirmeler izlenmez: deneme redirect ile başarısız olur ve teslimat günlüğü bunun yerine kullanılacak adresi gösterir.
• Bir komisyonla ilgili olayları birleştirmek için commission_id kullanın ve GET /v1/commissions ile mutabakat yapın: son 60 günün her gece okunması kaçırılan her şeyi yakalar.
• Yalnızca kullandığınız olayları işaretleyin. Her biri sunucunuza bir istektir.

OpenAPI dosyası

Dört imzalı endpoint, her durum ve neden bir numaralandırma (enum) olarak, kod üreteçleri ve API istemcileri için openapi.yaml (OpenAPI 3.1) dosyasında tanımlanır. Adresi değişmez.