Partner API — Hızlı Başlangıç

İlk bağlantınız tek bir ekrana sığar.

Şimdi deneyin — anahtar yok, kayıt yok

Bu adresi tarayıcınızda açın. Örnek etkinlikleri hemen görürsünüz.

https://timtim.live/api/partner-network/demo?city=Washington

1
Test anahtarı alın
Giriş yapın, kim olduğunuzu söyleyin ve Test Anahtarı Oluştur'a basın. Anahtar tt_test_ ile başlar ve sadece örnek etkinlikleri görür.

Etkinlik bulun

Bir şehirdeki etkinlikleri isteyin.

curl "https://api.timtim.live/v1/events?city=Washington&category=music" \
  -H "Authorization: Bearer tt_test_YOUR_KEY"

3
Etkinliği gösterin
Her etkinliğin adı, tarihi, yeri, görseli, fiyatı ve kartınız için hazır etiketleri vardır.
4
buy_url kullanın
Size verdiğimiz buy_url'yi kullanın. Hepsi bu. Satışın kaynağını TimTim.Live o bağlantının içinde kaydeder.
5
Sonuçları görün
Gönderdiğiniz kişileri, satılan biletleri ve kazançları panelinizde görün ya da isteyin.
GET https://api.timtim.live/v1/earnings

Test Anahtarımı Al Anahtarsız Deneyin

TimTim.Live Durumu

Başvuru

İstekler nereye gönderilir

https://api.timtim.live/v1

Bağlantı Anahtarınız

Anahtarınızı Authorization başlığında gönderin. Test anahtarları (tt_test_) sadece örnek etkinlikleri görür. Site anahtarları (tt_pk_live_) bir web sayfasında durabilir ve sadece etkinlikleri okur. Sunucu anahtarları (tt_sk_live_) sunucunuzda kalır ve kazançları da okuyabilir. Bir anahtarı sadece bir kez gösteririz — güvende tutun.

curl

curl "https://api.timtim.live/v1/events?city=Washington&category=music" \
  -H "Authorization: Bearer tt_test_YOUR_KEY"

JavaScript

const res = await fetch("https://api.timtim.live/v1/events?city=Washington&category=music", {
  headers: { Authorization: "Bearer tt_test_YOUR_KEY" },
});
const { events, next } = await res.json();
for (const event of events) {
  console.log(event.name, event.display.date_label, event.tickets.buy_url);
}

Node

// Node 18+ — keep server keys (tt_sk_live_) on the server
const res = await fetch("https://api.timtim.live/v1/events?city=Washington", {
  headers: { Authorization: `Bearer ${process.env.TIMTIM_KEY}` },
});
if (!res.ok) {
  const problem = await res.json();
  throw new Error(`${problem.title} (${problem.request_id})`);
}
const { events } = await res.json();

Python

import os, requests

res = requests.get(
    "https://api.timtim.live/v1/events",
    params={"city": "Washington", "category": "music"},
    headers={"Authorization": f"Bearer {os.environ['TIMTIM_KEY']}"},
)
res.raise_for_status()
for event in res.json()["events"]:
    print(event["name"], event["tickets"]["buy_url"])

PHP

<?php
$ch = curl_init("https://api.timtim.live/v1/events?city=Washington&category=music");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer " . getenv("TIMTIM_KEY")]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$data = json_decode(curl_exec($ch), true);
foreach ($data["events"] as $event) {
  echo $event["name"] . " " . $event["tickets"]["buy_url"] . PHP_EOL;
}

Filtreler

city: Bu şehirdeki etkinlikler.
country: İki harfli ülke kodu, örneğin US.
category: Örneğin music, festival veya conference.
from: Bu tarihte veya sonrasındaki etkinlikler (2026-10-20).
to: Bu tarihte veya öncesindeki etkinlikler.
changed_since: Sadece bu zamandan sonra değişen etkinlikler.
commissioned: true = sadece ödül ödeyen etkinlikler.
minimum_earnings: Sadece bilet başına en az bu kadar ödeyen etkinlikler.
near: Bir yer, örneğin near=Paris,FR.
limit: Sayfa başına kaç etkinlik, 1 ile 100 arası (yazmazsanız 20).

Bana sadece değişenleri söyle

Son eşitleme zamanınızı kaydedin ve changed_since olarak gönderin. Sadece değişen etkinlikleri alırsınız — iptaller ve biletleri tükenen gösteriler dahil. Webhook gerekmez. Göstermeyi bırakman gereken etkinlikler withdrawn listesinde gelir.

GET https://api.timtim.live/v1/events?changed_since=2026-10-06T10:00:00Z

Birden fazla sayfa

Yanıtta next varsa, sonraki sayfayı almak için onu cursor= olarak geri gönderin. next boş olduğunda her şeyi almışsınız demektir.

GET https://api.timtim.live/v1/events?city=Paris&cursor=eyJtIjoiZCIs…

Kazanç

Her etkinlikte earn vardır. earn.eligible false ise etkinliğin ödülü yoktur — yine de göstermeye değer. true ise earn.description ne alacağınızı söyler, örneğin "uygun bilet başına $5". Satın alma iade edilirse ödül geri alınır.

Toplu akışlar (her şey tek dosyada)

Panelinizde bir toplu akış kaydedin, sonra kapsadığı tüm etkinlikleri tek bir sıkıştırılmış dosyada indirin: GET /v1/bulk/FEED_ID.ndjson.gz veya .csv.gz, sunucu anahtarınızla. Yalnızca değişenler için ?changed_since= ekleyin, kaldırılan etkinlikler de dahil. Test anahtarları şimdiden deneyebilir; gerçek kullanım için TimTim.Live incelemesi gerekir.

GET https://api.timtim.live/v1/bulk/bfs_YOURFEED.ndjson.gz?changed_since=2026-10-06T00:00:00Z

Biletleri kendi uygulamanızda satın (gömülü satış)

Büyük ortaklar alıcıları kendi uygulamalarında tutabilir. Satışta ne olduğunu görmek için GET /v1/events/EVENT_ID/tickets isteyin, sonra alıcının seçimiyle POST /v1/orders gönderin. Alıcı için açacağınız bir TimTim.Live ödeme bağlantısı alırsınız; satış doğrudan şirketinize yazılır. Test anahtarları bunu şimdi deneyebilir. Gerçek kullanım için TimTim.Live incelemesi ve kartla ödemenin açık olması gerekir.

POST https://api.timtim.live/v1/orders  (Idempotency-Key: …)  {"event_id": "evt_test_washington_konpa", "ticket_type_id": "tt_test_washington_konpa", "quantity": 2, "buyer_email": "…", "buyer_name": "…"}

Karta bağlı teklifler (bankalar ve ödül programları)

GET /v1/offers ödül ödeyen her etkinliği bir teklif olarak verir: organizatör, satın alınabilecek tarihler, fiyat, yer ve ödül. Müşteriniz bunu takip edilen bağlantınız üzerinden etkinleştirir, ödül de /v1/earnings üzerinden şirketinize ödenir. Test anahtarları örnek teklifleri görür. Gerçek teklifler için TimTim.Live incelemesi gerekir. Kart ödemelerini doğrudan eşleştirmek bir kart ağı veya bankayla anlaşma gerektirir ve bağlı değildir.

GET https://api.timtim.live/v1/offers?country=US

Etkinlik durumu ve biletler

status değeri scheduled, postponed, rescheduled, cancelled, sold_out veya completed olur. tickets.availability değeri available, limited, sold_out, not_on_sale veya ended olur. Bir etkinlik iptal edilince onu kaldırın.

GET https://api.timtim.live/v1/events/evt_test_washington_konpa

Ne kadar hızlı sorabilirsiniz

Test anahtarları: dakikada 60 istek. Gerçek anahtarlar: dakikada 120. Daha hızlı giderseniz Retry-After ile birlikte 429 yanıtı alırsınız; bu, kaç saniye beklemeniz gerektiğidir.

Hangi etkinlikleri alırsınız

TimTim.Live organizatörlerinin oluşturduğu ve paylaşmayı seçtiği etkinlikler. Başka bilet sitelerinden aldığımız etkinlikler asla dahil edilmez, çünkü onları paylaşma hakkımız yok.

Asla göndermediklerimiz

Alıcı adları, e-posta adresleri, ev adresleri, telefon numaraları ve kart bilgileri. Partner API etkinlik bilgisini paylaşır, üyelerimizi değil.

Site widget'ı

Tek satır HTML, etkinlikleri herhangi bir sitede gösterir. Bir site anahtarı (tt_pk_live_) kullanın ve sitenizi anahtarın izinli listesine ekleyin. Anahtar yoksa örnek etkinlikler gösterir.

<script src="https://timtim.live/widget/events.js"
        data-key="tt_pk_live_YOUR_WEBSITE_KEY"
        data-city="Washington" data-category="music" async></script>

Seçenekler: data-city, data-country, data-category, data-limit (1–24), data-earn="true", data-lang ve data-color.

OAuth 2.0 (büyük entegrasyonlar)

İsteğe bağlı. Panelinizde bir OAuth istemcisi oluşturun. Sonra istemci kimliğini ve sırrını bir saatlik erişim jetonuyla değiştirin ve anahtar yerine bu jetonu gönderin. Sır, API isteklerinizle asla gitmez ve istemcinin sahip olduğundan daha az yetki (scopes) isteyebilirsiniz.

# 1. Trade the client ID and secret for a one-hour token
curl -u "$CLIENT_ID:$CLIENT_SECRET" \
  -d grant_type=client_credentials -d "scope=events:read events:details" \
  https://api.timtim.live/v1/oauth/token
# → {"access_token":"tt_at_…","token_type":"Bearer","expires_in":3600,"scope":"events:read events:details"}

# 2. Use the token exactly like a key
curl -H "Authorization: Bearer $ACCESS_TOKEN" "https://api.timtim.live/v1/events?city=Washington"

Bir jetonu erken bitirmek için onu aynı istemci kimliği ve sırla POST ile /v1/oauth/revoke adresine gönderin. İstemciyi panelinizde kapatırsanız tüm jetonları bir anda biter.

Bir anahtarı sunucularınıza kilitleyin

İsteğe bağlı. Panelinizde bir sunucu anahtarı, test anahtarı veya OAuth istemcisinin altındaki "Sunucularıma kilitle" bölümünü açın ve sunucularınızın genel adreslerini yazın. Başka her yerden gelen çağrılar — ve token istekleri — doğru anahtarla bile ip_not_allowed ile reddedilir.

İstemci sertifikaları (mTLS): TLS istemci sertifikanızı bir anahtara bağlayın, sonra https://api.timtim.live adresini bu sertifikayla çağırın. Her çağrı o sertifikayı göstermelidir; TLS el sıkışması, özel anahtarına sahip olduğunuzu kanıtlar.

# Your certificate's SHA-256 — paste this (or the PEM) under "Lock to my servers"
openssl x509 -in client.crt -noout -fingerprint -sha256

# Every call then presents the certificate
curl --cert client.crt --key client.key \
  -H "Authorization: Bearer $KEY" "https://api.timtim.live/v1/events?city=Washington"

WordPress eklentisi

WordPress mi kullanıyorsunuz? TimTim.Live Events'i kurun: kendi TimTim.Live bilet bağlantılarınızla etkinlikleri gösteren bir blok ve bir kısa kod. TimTim.Live tarafından yapıldı, yalnızca timtim.live ile konuşur ve yalnızca timtim.live üzerinden güncellenir.

Dosyayı Eklentiler → Yeni ekle → Eklenti yükle bölümünden yükleyin. Site anahtarınızı Ayarlar → TimTim.Live Events bölümüne yapıştırın ve Test Connection düğmesine basın. Sonra TimTim.Live Events bloğunu istediğiniz sayfaya ekleyin.

WordPress eklentisini indir

[timtim_events city="Washington" category="music" limit="6"]

Akışlar

Aynı etkinlikler JSON Feed, RSS, XML, CSV veya Google Calendar, Apple Calendar ve Outlook'un abone olabileceği bir takvim (.ics) olarak. Akış okuyucular başlık gönderemez, bu yüzden site anahtarını veya test anahtarını ?key= içine koyun. Sunucu anahtarını asla bir bağlantıya koymayın.

https://timtim.live/v1/feeds/events.json?key=tt_pk_live_YOUR_KEY&city=Paris
https://timtim.live/v1/feeds/events.rss?key=tt_pk_live_YOUR_KEY&city=Paris
https://timtim.live/v1/feeds/events.xml?key=tt_pk_live_YOUR_KEY&city=Paris
https://timtim.live/v1/feeds/events.csv?key=tt_pk_live_YOUR_KEY&city=Paris
https://timtim.live/v1/feeds/events.ics?key=tt_pk_live_YOUR_KEY&city=Paris

Webhook'lar

Panelinizde "Adres Ekle"ye basın; bir şey değişince o adrese mesaj göndeririz: event.changed veya earnings.changed. Webhook'lar isteğe bağlıdır — changed_since size aynı bilgiyi verir.

{
  "id": "whd_8Fk2mQxR7tLp",
  "type": "event.changed",
  "created_at": "2026-10-06T15:04:05.000Z",
  "mode": "live",
  "data": {
    "event": {
      "id": "ev_…",
      "name": "…",
      "status": "cancelled",
      "tickets": {
        "availability": "ended",
        "buy_url": "https://timtim.live/b/…"
      },
      "…": "the same event object as GET /v1/events"
    }
  }
}

Her mesajı kontrol edin: mesaj sizin gizli anahtarınızla imzalıdır. Beş dakikadan eski her şeyi reddedin ve daha önce işlediğiniz bir TimTim-Delivery-Id'yi yok sayın.

// Node — Express with the RAW body (do not JSON.parse before checking)
import crypto from "node:crypto";

app.post("/timtim", express.raw({ type: "application/json" }), (req, res) => {
  const header = req.get("TimTim-Signature") ?? "";           // t=1700000000,v1=<hex>
  const parts = Object.fromEntries(header.split(",").map((p) => p.split("=")));
  const body = req.body.toString("utf8");
  const expected = crypto.createHmac("sha256", process.env.TIMTIM_WEBHOOK_SECRET)
    .update(`${parts.t}.${body}`).digest("hex");
  const fresh = Math.abs(Date.now() / 1000 - Number(parts.t)) <= 300;
  const same = expected.length === (parts.v1 ?? "").length &&
    crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(parts.v1));
  if (!fresh || !same) return res.sendStatus(400);

  const message = JSON.parse(body);                            // { id, type, mode, data }
  if (alreadyHandled(req.get("TimTim-Delivery-Id"))) return res.sendStatus(200);
  // message.type === "event.changed"    → message.data.event
  // message.type === "earnings.changed" → message.data.earning
  res.sendStatus(200);
});

10 saniye içinde herhangi bir 2xx ile yanıt verin. Vermezseniz 1 dakika, 5 dakika, 30 dakika, sonra 2, 6, 12 ve 24 saat sonra tekrar deneriz, sonra dururuz. Yönlendirmeleri asla takip etmeyiz.

Test ortamı

Test anahtarları TEST ETKİNLİĞİ — GERÇEK PARA YOK etiketli örnek etkinlikler alır. Bir buy_url açın, Test Bileti Al'a basın, sonra kazançlarınızı isteyin. Bir iadeyi deneyin ve geri alındığını görün.

Bir şeyler ters gittiğinde

Hatalar kendilerini basit sözlerle, bir başlık ve sonra ne yapılacağıyla açıklar. Her yanıtta bir TimTim-Request-Id bulunur. Bize gönderin, isteğinizi bulalım.

401missing_keyPlease add your TimTim.Live key. Send it as: Authorization: Bearer tt_test_… — get a test key at /partners/dashboard.
401invalid_keyWe do not recognise that key. Check you copied the whole key, or make a new one at /partners/dashboard.
401revoked_keyThat key was switched off. Make a new key at /partners/dashboard.
403partner_inactiveThis partner account cannot use live keys right now. Your test key still works. Contact TimTim.Live partnerships to review the account.
403missing_scopeThis key is not allowed to do that. Earnings need a secret key (tt_sk_live_…) or a test key, used from your server.
403domain_not_allowedThis website is not allowed to use this key. Add the website to the key's allowed domains at /partners/dashboard.
400unknown_parameterWe do not know one of those parameters. See /partners/docs for the list.
400invalid_countryWe could not read that country. Use a two-letter code, for example country=US or country=FR.
400invalid_dateWe could not read that date. Dates look like 2026-10-20.
400invalid_changed_sinceWe could not read changed_since. Use a full time, for example changed_since=2026-10-06T10:00:00Z.
400invalid_booleanThat value must be true or false. For example commissioned=true.
400invalid_numberThat value must be a number. For example minimum_earnings=5.
400invalid_nearWe could not find that place. Try near=Paris,FR or city=Paris&country=FR.
400invalid_locationWe could not read that location. Send lat, lng and optionally radius in kilometres.
400invalid_limitlimit must be between 1 and 100. Leave it out to get 20.
400invalid_cursorThat cursor is not one we gave you. Use the `next` value from the previous page exactly as it came.
404event_not_foundWe could not find that event. It may have been removed, or it is not shared with partners.
403capability_requiredCard-linked offers are not switched on for your account. Offers are an enterprise feature. Your test key shows sample offers now; ask TimTim.Live partnerships to review your account for live offers.
403server_key_requiredThis is for your server only. Use a secret key (tt_sk_live_…) or a test key from your server, never a website key in a web page.
403commerce_not_enabledSelling tickets in your own app is not switched on for your account. This is an enterprise feature (EMBEDDED_CHECKOUT). Your test key can try it now; ask TimTim.Live partnerships to review your account. Until then, use each event's buy_url.
503checkout_not_openCard payments are not open on TimTim.Live yet. Send the buyer to the event's buy_url instead. Your test key can still rehearse orders.
409ticket_not_availableThat ticket cannot be bought right now. It may be sold out, not on sale yet, or no longer on sale. Ask /v1/events/{id}/tickets for what is on sale now.
400order_invalidWe could not read that order. See /partners/docs for the fields an order needs.
400idempotency_key_requiredPlease send an Idempotency-Key header. 8 to 80 letters, digits, - or _. Send the same key again to retry safely — you will get the same order, never a second one.
404order_not_foundWe could not find that order. Only orders your company began with this kind of key (test or live) can be read here.
403bulk_not_enabledBulk feeds are not switched on for your account. This is an enterprise feature (BULK_FEEDS). Your test key can try it now; ask TimTim.Live partnerships to review your account. Until then, page through /v1/events or the feeds.
404bulk_not_foundWe could not find that bulk feed. Use the address shown on /partners/dashboard: /v1/bulk/<subscription id>.ndjson.gz or .csv.gz.
429bulk_too_soonA full file was made for this feed a few minutes ago. Full files can be made every 15 minutes. For what changed since, add changed_since=<time> — that is not limited.
410event_withdrawnThis event is no longer shared with partners. Stop showing it and remove its buy_url. Nothing else is needed — your old link still takes people to the event page.
400invalid_trackWe could not read that tracking signal. Send {"type":"impression"}, {"type":"event_view","event_id":"…"} or {"type":"event_click","event_id":"…"}. Sales are recorded by TimTim.Live, never sent from a page.
404not_foundThere is nothing at this address. The Partner API lives at /v1/events, /v1/events/{id}, /v1/offers and /v1/earnings.
405method_not_allowedThis address does not answer that method. The Allow header lists the methods it answers.
401key_in_urlSend your key in the Authorization header. Only /v1/feeds reads a key from the URL (?key=). Everywhere else use Authorization: Bearer <key> — keys in URLs end up in logs.
403ip_not_allowedThis key only works from your listed servers. Call from an address on the key's allowlist, or change the list at /partners/dashboard.
401certificate_requiredThis key needs your client certificate. Connect to https://api.timtim.live with the TLS client certificate pinned to this key.
401certificate_mismatchThat is not the certificate pinned to this key. Use the certificate whose SHA-256 is on your dashboard, or pin the new one there.
429rate_limitedToo many requests — please slow down. Wait the number of seconds in Retry-After, then try again.
503unavailableThe Partner API is resting for a moment. Please try again in a minute.
500server_errorSomething went wrong on our side. Please try again. If it keeps happening, send us your TimTim Request ID.

Sözleşme

Her alanın tam açıklaması, araçlarınızın okuyabildiği OpenAPI biçiminde.

openapi.yaml İndir

Canlı anahtarlar nasıl açılır

Test anahtarınız hemen çalışır. Canlı anahtarlar için TimTim.Live'dan bir kişi şirketinizin adına, web sitenize ve etkinlikleri nasıl göstereceğinize bakar. Cevabı panelinizde görürsünüz.

TimTim.Live API Güncellemeleri

Sürüm 1 sadece büyür. Yeni şeyler ekleriz. Var olanı silmeyiz ve adını değiştirmeyiz.

2026-10-08 — Etkinlik yanıtlarında artık bir ETag var. Hiçbir şey değişmediğinde hızlı bir 304 almak için onu If-None-Match ile geri gönderin. İsteğe bağlı.
2026-10-08 — Web sitesi anahtarları artık her ziyaretçiyi ayrı sayıyor, böylece yoğun siteler çalışmaya devam ediyor. Bir şey yapmanıza gerek yok.
2026-10-07 — İstemci sertifikaları (mTLS) açıldı: sertifikanızı panelinizde bir anahtara bağlayın. İsteğe bağlı. Bir şey yapmanıza gerek yok.
2026-10-07 — Toplu akışlar: gösterebileceğiniz her etkinlik, tek dosyada, GET /v1/bulk adresinde. İsteğe bağlı. Bir şey yapmanıza gerek yok.
2026-10-07 — API'nin artık kendi adresi var: https://api.timtim.live/v1. https://timtim.live/v1 çalışmaya devam ediyor. Bir şey yapmanız gerekmiyor.
2026-10-06 — timtim.live/checkout adresinde kendi markanızla ödeme sayfası. İsteğe bağlı. Bir şey yapmanıza gerek yok.
2026-10-06 — Biletleri kendi uygulamanızda satın: GET /v1/events/EVENT_ID/tickets ve POST /v1/orders. İsteğe bağlı. Bir şey yapmanıza gerek yok.
2026-10-06 — /partners/status adresinde herkese açık bir durum sayfası, her dakika kontrol edilir. Bir şey yapmanıza gerek yok.
2026-10-06 — Şirketler için aylık hesap özetleri: GET /v1/settlements. Bir şey yapmanıza gerek yok.
2026-10-06 — Postback'ler: bir satın alma bağlantısına ?sub_id= ekleyin, onu satışla birlikte size geri göndeririz. İsteğe bağlı. Bir şey yapmanıza gerek yok.
2026-10-06 — Bankalar ve ödül programları için karta bağlı teklifler: GET /v1/offers. İsteğe bağlı. Bir şey yapmanıza gerek yok.
2026-10-06 — Takvim akışı: Google Calendar, Apple Calendar ve Outlook için /v1/feeds/events.ics. Bir şey yapmanız gerekmez.
2026-10-06 — Bir anahtarı sunucularınıza kilitleyin: IP izin listeleri şimdi, istemci sertifikaları (mTLS) api.timtim.live üzerinde. İsteğe bağlı. Bir şey yapmanız gerekmez.
2026-10-06 — Büyük entegrasyonlar için OAuth 2.0 client credentials: POST /v1/oauth/token ve /v1/oauth/revoke. Anahtarlar çalışmaya devam eder. Bir şey yapmanıza gerek yok.
2026-10-06 — WordPress eklentisi 1.0.0: bir blok, bir kısa kod ve bir ayarlar sayfası. Kendini timtim.live üzerinden günceller. Bir şey yapmanıza gerek yok.
2026-10-06 — Site widget'ı, JSON/RSS/XML/CSV akışları ve webhook'lar (event.changed, earnings.changed). Bir şey yapmanıza gerek yok.
2026-10-06 — Partner API v1: etkinlikler, tek etkinlik, kazançlar ve test ortamı. Bir şey yapmanıza gerek yok.