Ræsa

Fyrsta sameining ūín passar á einn skjá.

Reyndu það núna ◆ Enginn lykill, ekkert undirritað

Opna þetta vistfang í vafranum þínum. Þú munt sjá sýningaratburði strax.

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

1
Fá próflykil
Skráðu þig inn, segðu okkur hver þú ert og ýttu á Búa til Prufulykil. Það byrjar á tt_ test_ og sér einungis sýningaratburði.

Finna atburði

Biddu um atburđi í borg.

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

3
Sýna atburð
Sérhver atburður hefur nafn, dagsetningu, stað, mynd, verð og tilbúið merkimiða fyrir kortið þitt.
4
Nota
Nota kaup_ url við gefum þér. Svona. TimTim.Live handföng sem eru rakin inn í ūennan hlekk.
5
Skoða niðurstöður
Sjá fólk senda, miða selja og vinna á djammborðinu eða biðja um þá.
GET https://api.timtim.live/v1/earnings

Ná í próflykilinn minn Reyndu hana án lykils

TimTim.Live Staða

Tilvísun

Hvar á að senda beiðnir

https://api.timtim.live/v1

Tengingalykillinn þinn

Sendið lykilinn í auðkennishausinn. Prufulyklar (t_ test_) sjá aðeins sýna atburði. Vefsvæðislyklar (t_ pk_ hour_ hour) geta setið á vefsíðu og aðeins lesið atburði. Lyklar þjóns (t_ ssk_ lifandi_) halda sig á þjóninum þínum og geta einnig lesið tekjur. Viđ sũnum lykil ūegar viđ höfum haldiđ honum öruggum.

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;
}

Síur

city: Atburđir í ūessari borg.
country: Tveggja stafa landskķđi, til dæmis Bandaríkjunum.
category: Til dæmis tķnlist, hátíđ eđa ráđstefnu.
from: Tilvik á eða eftir þeim degi (2026-1020).
to: Atburðir á eða fyrir þennan dag.
changed_since: Ađeins atburđir sem breyttust eftir ūennan tíma.
commissioned: Satt = aðeins atburðir sem borga verðlaun.
minimum_earnings: Bara atburđir sem borga svona mikiđ í sekt.
near: Stađ, t.d. nálægt=Paris,FR.
limit: Hversu margir atburðir á blaðsíðu 1 til 100 (20 ef þú skilur það ekki).

Segđu mér hvađ breyttist.

Vista tíma sem síðasta samstilling þín er og senda hana sem breytt_ því. Mađur fær bara atburđi sem breyttu um ◆, ūar á međal cancellations og uppseltar sũningar. Engin ūörf fyrir vefhook. Atburðir sem þú verður að hætta að sýna í listanum.

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

Fleiri en ein síða

Ef svarið er næst, sendu það til baka sem bendill= að fá næstu síðu. Næst er allt á hreinu.

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

Eyru

Hver viđburđur hefur grætt. Ef tekjur. Hæfileg laun eru röng hefur atburðurinn engin laun ◆ það er enn þess virði að sýna þau. Ef ūađ er satt, ūá segir ávísunin ūađ sem ūú færđ, t.d. "5 dalir á hvern gjaldmiđa." Ef kaupinu er endurgoldið er umbuninni snúið við.

Bulk straumar (allt í einni skrá)

Geymdu stóran straum á mælaborđinu. Síðan halað niður öllum tilvikum sem hún nær yfir í einni zed skrá með lykil miðlarans: GET / v1/bulk/FED_ID.ndjson.gz eða.csv.gz. Bæta við? Breytt_ síðan= fyrir aðeins það sem breyttist, þ.m.t. tilvikin tekin niður. Próflyklar geta prófað það núna; notkun í beinni útsendingu þarf að fara yfir TimTim.Live.

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

Selja miða í þínu eigin forriti (viðskipti)

Stórir félagar geta haldið kaupendum í sínu eigin forriti. Spurðu GET/v1/Marts/EVEN_ID/titwets um það sem er á útsölu, síðan POST /v1/words með vali kaupandans. Þú færð TimTim.Live greiðslutengi til að opna fyrir kaupanda, sölu er eignað fyrirtækinu þínu beint. Prufulyklar geta reynt ūađ núna. Ūađ ūarf ađ leggja upp um TimTim.Live og skipta af kortum.

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": "…"}

Kortatengd tilboð (bankar og endurgreittar áætlanir)

GET / v1/offers sýna hvern atburð sem launar honum. Sérhvert tilbođ hefur skipuleggjanda, dagsetningarnar sem ūú getur keypt, verđiđ, stađinn og verđlaunin. Viđskiptavinur ūinn virkjar hann gegnum tengilinn ūinn og launin eru greidd til fyrirtækisins í gegnum /v1/earing. Lyklar sjá prufutilbođ. Lífstilbođ ūurfa TimTim.Live umfjöllun. Það þarf að semja kortaskuldir við kortanet eða banka án tengsla.

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

Staða tilvika og miðar

Áætlað er að komið sé á fót stöðu, frestað, afturkallað, selt_u eða er lokið. Miðar eru fyrir hendi, takmarkað, selt_ út, ekki beint eða þeim er lokið. Þegar viðburður er afturkallaður, taktu hann þá niður.

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

Hversu hratt ūú getur beđiđ

Prufulyklar: 60 beiðnir á mínútu. Lifandi lyklar: 120 á mínútu. Ūeir sem eru hrađskreiđari fá 429 svar međ Retry-eftir, hve margar sekúndur á ađ bíđa.

@ info: whatsthis

Atburðir sem TimTim.Live skipuleggja og velja að deila. Atburðir, sem við fluttum frá öðrum miðunarstöðum, eru aldrei innifalið því að við eigum ekki rétt á að deila þeim.

Ūađ sem viđ sendum aldrei

Kaupendurnöfn, netföng, heimilisföng, símanúmer og kortaupplýsingar. API félaginn deilir upplũsingum, ekki međlimum okkar.

Vefsíða

Ein lína af HTML sýnir viðburði á hvaða vefsvæði sem er. Nota vefsíðulykil (t_ pk_ hour_) og bæta vefsíðunni þinni við listann. Þar sem enginn lykill er, sýnir hann atvik.

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

Valmöguleikar: gagnvirkni, gagnanotkun, gagnasafn, gagnatakmark (17,24), gagna- aurn="true", gagna- og gagna- litun.

OAuth 2,0 (stór samþætting)

Aukalegt. Gerđu OAuth ađ skjķlstæđingi á mælaborđinu ūínu. Skiptu umbjķđanda og leyndarmáli fyrir ađgangsmerki sem varir í klukkutíma. Sendiđ merkiđ í stađ lykils. Leyndarmálið ferðast aldrei með API símhringingum þínum og þú getur beðið um færri stig en viðskiptavinurinn hefur.

# 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"

Til að binda enda á tákn snemma, POST það til /v1/oauth/ reevoke með sama auðkenni og leyndarmál biðlara. Ef ūú gerir viđ viđskiptavininn á mælaborđinu ūínu endar hann á öllum táknum í einu.

Læsa lykli að þjónum þínum

Aukalegt. Finndu lykil fyrir miðlarann þinn, próflykil eða OAuth biðlara. Opna "Læsa til þjóna" og lista yfir opinber netföng þjóna þinna. Hringir ◯ og beiðnir um tákn ◯ hvar sem er annars staðar er hafnað með ap_ not_ not_ hosted, jafnvel með réttum lykli.

Skírteinisskírteini (mTLS) fyrir stór fyrirtæki: láttu okkur fá auðkennisskírteini miðlarans (skírteini) og sendu það á lykil. Hringdu síðan í https://appi.tit.liggur með það. Viđ svörum bara ūeim netūjķni sem geymir skírteiniđ.

# 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 íforritName

Nota WordPress? Setja upp TimTim.Live atburði: blokk og stuttkóða sem sýna atburði með eigin TimTim.Live miðum. Það er gert af TimTim.Live, talar aðeins við timim.ive og uppfærslur eingöngu frá timti.

Sendið skrána í íforritin → Bæta við nýjum → sendingu íforritum. Líma vefsíðulykilinn þinn í Stillingar → TimTim.Live Atburðir og ýttu á Prufutengingu. Bættu svo viđ TimTim.Live viđburđunum á hverja síđu.

Sækja WordPress íforritið

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

Straumar

Sömu atburðir og JSON straumur, RSS, XML, CSV eða dagatalsskrá (.ics). Dagatal, Apple dagatal og Outlook geta verið áskrifandi að dagatalinu. Straumur lesendur geta ekki sent hausa. Settu því vefvistarlykil eða próflykil í key=. Aldrei setja miðlaralykil í tengil.

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

VefhooksName

Bæta við heimilisfangi á mælaborðinu og við sendum það skilaboð þegar eitthvað breytist: atburður, breyttur eða tekjukaupum. Breytt. Vefhooks eru valfrjálst val, breytt_þar sem sömu upplýsingar eru gefnar.

{
  "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"
    }
  }
}

Athugaðu öll skilaboð: þau eru undirritað með leyndarmáli þínu. Hafnaðu öllu sem er eldra en fimm mínútur, og hunsaðu TimTim-Frelsi-Id sem þú hefur þegar höndlað.

// 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);
});

Svar með 2xx innan 10 sekúndna. Ef ekki, þá reynum við aftur eftir 1 mínútu, 5 mínútur, 30 mínútur, síðan 2, 6, 12 og 24 klst. Viđ fylgjum aldrei leiđbeiningum.

Sandkassinn

Prufulyklar fá sýnishorn merkt TEST EVEN ◆ NOAL MONEY. Opnaðu kaup_ url, ýttu á Teikningarmiða og biddu svo um tekjur. Líkja eftir endurgreitt og horfa á ūađ snúa viđ.

Ūegar eitthvađ fer úrskeiđis

Villur útskýra sig í skýrum orðum með titli og hvað eigi að gera næst. Öll svör bera međ sér TimTim-Sever-Id. Sendu ūađ til okkar og viđ finnum ķsk ūína.

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.
409idempotency_conflictThat Idempotency-Key was already used for a different order. Send exactly the same order to get the same answer back, or use a new Idempotency-Key for a new order.
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.

Samningurinn

Ítarleg lýsing á hverju svæði, í OpenAPI sniði verkfæra þinna getur lesið.

Hlaða niður openapi.yaml

Hvernig lifandi lyklar opna

Próflykillinn virkar strax. Fyrir lifandi lykla lítur einstaklingur klukkan TimTim.Live á nafn fyrirtækisins, vefsíðuna þína og hvernig þú ætlar að sýna atburði. Ūú sérđ svariđ á mælaborđinu ūínu.

TimTim.Live API uppfærsla

Útgáfa 1 vex aðeins. Viđ bætum viđ nũjum hlutum. Við fjarlægjum ekki eða endurnýjum það sem er þegar til.

2026-10-08 — Svör við þessum atburði bera nú ETag. Sendu ūađ til baka sem ef-einn-Match fær snöggan 304 ūegar ekkert breyttist. Aukalegt.
2026-10-08 — Lyklar á vefsvæðinu telja nú alla gestina sína, svo önnum kafnir staðir halda áfram að virka. Ekki þörf á neinum aðgerðum.
2026-10-07 — Skírteinanotkun Aukalegt. Ekki þörf á neinum aðgerðum.
2026-10-07 — Bulk straumar: Sérhver atburður sem þú getur sýnt, í einni skrá, á GET / v1/bulk. Aukalegt. Ekki þörf á neinum aðgerðum.
2026-10-07 — API hefur sitt eigið vistfang: https://appi.titim.ive/v1. https://tithim.ive./v1 heldur áfram að virka. Ekki þörf á neinum aðgerðum.
2026-10-06 — Ūetta er ūín eigin merkta gátsíđa á timti. Lifandi/athugađ. Aukalegt. Ekki þörf á neinum aðgerðum.
2026-10-06 — Seldu miða í þínu eigin forriti: GET / v1/ Mouts/EVEN_ID/tacks og POST / v1/ders. Aukalegt. Ekki þörf á neinum aðgerðum.
2026-10-06 — Opinber stöðusíða á /partners/status, athugað hverja mínútu. Ekki þörf á neinum aðgerðum.
2026-10-06 — Mánaðarlegar skýrslur fyrir fyrirtæki: GET/v1/surð. Ekki þörf á neinum aðgerðum.
2026-10-06 — Póstur: bæta við? sub_ id= við kauptengi og við sendum það aftur til þín með söluna. Aukalegt. Ekki þörf á neinum aðgerðum.
2026-10-06 — Kortatengd tilboð fyrir banka og endurgreitt forrit: GET / v1/offers. Aukalegt. Ekki þörf á neinum aðgerðum.
2026-10-06 — Dagatalsfóður: /v1/ fóður/tilvik.ics fyrir Google dagatal, Apple dagatal og Outlook. Ekki þörf á neinum aðgerðum.
2026-10-06 — Læsið lykli til þjóna þinna: IP leyfa nú, auðkennisskírteini (mTLS) á pi.tim.ive. Aukalegt. Ekki þörf á neinum aðgerðum.
2026-10-06 — OAuth 2,0 biðlari fyrir stóra samþættingu: POST / v1/ oauth/token og /v1/oauth/ recoke. Lyklarnir virka áfram. Ekki þörf á neinum aðgerðum.
2026-10-06 — WordPress íforrit 1. 0. 0. 0: blokk, stuttur kóði og stillingasíða. Hún upplũsir sig frá timti. Lifir. Ekki þörf á neinum aðgerðum.
2026-10-06 — Vefsvæðisgræju, JSON/RS/XML/CSV straumar og vefhooks (jafna, breytta, skipta um laun.d). Ekki þörf á neinum aðgerðum.
2026-10-06 — Sameignarfélagi: Atburðir, einn atburður, tekjur og sandkassinn. Ekki þörf á neinum aðgerðum.