ସହଯୋଗୀ API — ତୁରନ୍ତ ଆରମ୍ଭ

ଆପଣଙ୍କର ପ୍ରଥମ ସଂଯୋଗଟି ଗୋଟିଏ ପରଦାରେ ମେଳ ଖାଉଛି ।

ବର୍ତ୍ତମାନ ଏହାକୁ ଚେଷ୍ଟାକରନ୍ତୁ — କୌଣସି କି ନାହିଁ, କୌଣସି ସ୍ବୀକାରକରଣ ନାହିଁ

ଏହି ଠିକଣାକୁ ଆପଣଙ୍କ ବ୍ରାଉଜରରେ ଖୋଲନ୍ତୁ। ଆପଣ ଶିଘ୍ର ସଙ୍ଗେ ନମୁନା ଦେଖିଛନ୍ତି।

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

1
ଗୋଟିଏ ପରୀକ୍ଷଣ କି ଗ୍ରହଣ କରନ୍ତୁ
ଲଗଇନ କରନ୍ତୁ, କେଉଁ ହୁଅନ୍ତି ସେହି ବ୍ୟକ୍ତି ଦବାନ୍ତୁ, ପରୀକ୍ଷଣ କି ସୃଷ୍ଟିକରନ୍ତୁ। ଏହା tt_ଟେଷ୍ଟ ସହିତ ଆରମ୍ଭ ହୋଇଥାଏ ଏବଂ କେବଳ ନମୁନା ଘଟଣାଗୁଡ଼ିକୁ ଦେଖିଥାଏ।
2
ଘଟଣାଗୁଡ଼ିକୁ ଖୋଜନ୍ତୁ
ଗୋଟିଏ ସହରେ ଥିବା ଘଟଣାଗୁଡ଼ିକ ପାଇଁ ପଚାରନ୍ତୁ।
curl "https://api.timtim.live/v1/events?city=Washington&category=music" \ -H "Authorization: Bearer tt_test_YOUR_KEY"
3
ଘଟଣାକୁ ପ୍ରଦର୍ଶନ କରନ୍ତୁ
ପ୍ରତ୍ୟେକ ଘଟଣାର ଆପଣଙ୍କ କାର୍ଡ ପାଇଁ ଗୋଟିଏ ନାମ, ତାରିଖ, ସ୍ଥାନ, ପ୍ରତିଛବି, ମୂଲ୍ୟ ଏବଂ ପ୍ରସ୍ତୁତ ଲେଖକ ଅଛି।
4
ନିର୍ଦ୍ଦିଷ୍ଟ ବ୍ୟବହାର କରନ୍ତୁ (_u)
ଆମେ ଆପଣଙ୍କୁ ଦେଇଛନ୍ତି ନିଜକୁ ବ୍ୟବହାର କରନ୍ତୁ (_u)। ତେବେ । TimTim.Live ସେ ସଂଯୋଗ ଭିତରେ ବର୍ଣ୍ଣନା 9001 ନିୟନ୍ତ୍ରଣ।
5
ଫଳାଫଳ ଦେଖନ୍ତୁ
ପଠାଯାଇଥିବା ବ୍ୟକ୍ତିମାନଙ୍କୁ ଦେଖନ୍ତୁ, ଆପଣଙ୍କର ଡ୍ୟାସବୋର୍ଡରେ ବିକରୁଥିବା ଓ ଚେତାବନୀ, ଅଥବା ସେମାନଙ୍କ ପାଇଁ ପଚାରନ୍ତୁ।
GET https://api.timtim.live/v1/earnings

ମୋର ପରୀକ୍ଷଣ କି ଗ୍ରହଣ କରନ୍ତୁ କି ବିନା ଚେଷ୍ଟାକରନ୍ତୁ

TimTim.Live ଅବସ୍ଥିତି

ସନ୍ଦର୍ଭ

ଅନୁରୋଧଗୁଡ଼ିକୁ କେଉଁଠି ପଠାଇବା ଉଚିତ

https://api.timtim.live/v1

ଆପଣଙ୍କର ସଂଯୋଗ କି

ବୈଧିକରଣ ଶୀର୍ଷକରେ ଆପଣଙ୍କର କି ପଠାନ୍ତୁ। କି ପରୀକ୍ଷଣ କରନ୍ତୁ (tt_) କେବଳ ନମୁନା ଘଟଣାଗୁଡ଼ିକୁ ଦେଖନ୍ତୁ। ୱେବସାଇଟ କି (tt_pk_live_) ଗୋଟିଏ ୱେબ ପୃଷ୍ଠାରେ ଏବଂ କେବଳ ଘଟଣାଗୁଡ଼ିକ ପଢ଼ିପାରିବ। ସର୍ଭର କି (tt_sk_live_) ଆପଣଙ୍କ ସର୍ଭରରେ ରଖିଥାଏ ଏବଂ ଲକ୍ଷ୍ୟକ ମଧ୍ଯ ପଢ଼ିପାରିବ। ଆମେ ଏକ କି ଥରେ ଦର୍ଶାଇଛନ୍ତି — ଏହାକୁ ସୁରକ୍ଷିତ ରଖନ୍ତୁ।

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

ଛାଣକଗୁଡ଼ିକ

city: ଏହି ସହରେ ଘଟଣାଗୁଡ଼ିକ।
country: ଦୁଇ ଅକ୍ଷର ଦେଶ କୋଡ, ଉଦାହରଣ US ।
category: ଉଦାହରଣ ସଙ୍ଗୀତ, ପ୍ରତ୍ୟେକ ଅଥବା ସମ୍ମେଳନ ।
from: ଏହି ତାରିଖରେ କିମ୍ବା ପରେ ଘଟଣାଗୁଡ଼ିକ (2026-10-20)।
to: ଏହି ତାରିଖ ଉପରେ କିମ୍ବା ପୂର୍ବରୁ ଘଟଣାଗୁଡ଼ିକ।
changed_since: ଏହି ପରେ କେବଳ ଘଟଣାଗୁଡ଼ିକ ପରିବର୍ତ୍ତିତ ହୋଇଛି।
commissioned: true = କେବଳ ପୁନରାବୃତ୍ତି ଦେଇଥିବା ଘଟଣାଗୁଡ଼ିକ।
minimum_earnings: ପ୍ରତ୍ୟେକ ଟିକଟରେ ଏପରି ଅତିକମକୁ ଦେଇଥିବା କେବଳ ଘଟଣାଗୁଡ଼ିକ ।
near: ଗୋଟିଏ ସ୍ଥାନ, ଉଦାହରଣ ସର୍ଭିସ=ପାରିସ,FR ।
limit: ପ୍ରତ୍ୟେକ ପୃଷ୍ଠାରେ କେତେ ଘଟଣା ହେଉଛି ତେବେ ଆପଣ ଏହାକୁ ତ୍ୟାଗ କରିଛନ୍ତି ।

କେବଳ ମୋତେ ପରିବର୍ତ୍ତନ ହେଲା ପଚାରନ୍ତୁ

ଆପଣଙ୍କର ଅନ୍ତିମ ସମକାଳୀନ ସମୟକୁ ସଂରକ୍ଷଣ କରନ୍ତୁ ଏବଂ ପରିବର୍ତ୍ତିତ ଭାବରେ ପଠାନ୍ତୁ। ଆପଣ କେବଳ ପରିବର୍ତ୍ତିତ ଘଟଣା ପାଇଛନ୍ତି — ବାତିଲ ଏବଂ ବିତରଣ ପ୍ରଦର୍ଶନଗୁଡ଼ିକୁ ଅନ୍ତର୍ଭୁକ୍ତ କରି। କୌଣସି ୱେବହୁକ ଆବଶ୍ୟକ ନାହିଁ । ଆପଣ ପଦକ୍ଷେପ ବାତିଲ ତାଲିକାରେ ଦର୍ଶାଇବାକୁ ବନ୍ଦ କରିବା ଉଚିତ।

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

ଗୋଟିଏରୁ ଅଧିକ ପୃଷ୍ଠା

ଯଦି ଉତ୍ତରର ଥାଏ, ତେବେ ଏହାକୁ ସୂଚକ= ପରବର୍ତ୍ତୀ ପୃଷ୍ଠା ପାଇବା ପାଇଁ ପଠାନ୍ତୁ । ପରବର୍ତ୍ତି ସବୁକି ଖାଲି ଥିବା ତେବେ ଆପଣଙ୍କ ପାଖରେ ସବୁ ଅଛି ।

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

ଫଳାଫଳ କରୁଅଛି

ପ୍ରତ୍ୟେକ ଘଟଣା ଲାଗିଛନ୍ତି। ଚେତାବନୀ ହେଲେ, ଭୁଲ ଅଟେ, ଏହି ଘଟଣାର କୌଣସି ପୁରୁଣା ପୁଣି — ଏହା ଏପର୍ଯ୍ୟନ୍ତ ପ୍ରଦର୍ଶନ କରିବାର ମୂଲ୍ୟ । ଯଦି ଏହା ସବୁଠାଯାଇଥାଏ, ତେବେ rent.description କଣ ଆପଣ ପାଇଛନ୍ତି ତାହା କହିଥାଏ, ଉଦାହରଣ ସ୍ୱରୂପ "$5 ପ୍ର ପ୍ର ପ୍ରଯୋଗ୍ୟ ତିକଟ।" ଯଦି ଚେତାବନୀ ଫେରାଇଥାଏ, ତେବେ ପୁନରାବୃତ୍ତି ହୋଇଥାଏ।

ଗୁରୁତ୍ବପୂର୍ଣ୍ଣ ପତ୍ର (କୌଣସି ଫାଇଲରେ ସବୁକିଛି)

ଆପଣଙ୍କର ଡ୍ୟାସବୋର୍ଡରେ ଗୋଟିଏ ବହୁ ଫିଡ ସଂରକ୍ଷଣ କରନ୍ତୁ। ତାପରେ ଏହା ଗୋଟିଏ ziped ଫାଇଲରେ ଆବୃତ ପ୍ରତ୍ୟେକ ଘଟଣାକୁ ଆହରଣ କରନ୍ତୁ, ଆପଣଙ୍କ ସର୍ଭର କି ସହିତ: GET /v1/bulk/FEED_ID.ndjson.gz କି କିମ୍ବା .csv.gz। ? ପରିବର୍ତ୍ତନିତ_sene= କେବଳ କଣ ପରିବର୍ତ୍ତିତ ହେଉଛି, ନିମ୍ନଭାବ ମଧ୍ଯରେ । ପରୀକ୍ଷଣ କି ବର୍ତ୍ତମାନ ଏହାକୁ ଚେଷ୍ଟା କରିପାରିବ; ଜୀବନ୍ତ ବ୍ୟବହାର ଗୋଟିଏ TimTim.Live ଅନୁସ୍ଥିତି ଆବଶ୍ୟକ ।

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

ଆପଣଙ୍କର ପ୍ରଯୋଗରେ ଟିକଟଗୁଡିକ ବିଚ କରନ୍ତୁ (ସବୁଦିନ ବ୍ୟବସାୟ)

ବଡ଼ ସହଯୋଗୀମାନେ ନିଜର ପ୍ରୟୋଗରେ ଛାଣକ ରଖିପାରିବ । GET /v1/events/EVENT_ID/stickets କଣ ବିକ୍ରୟରେ ଅଛି, ତାପରେ POST /v1/ ନିର୍ଦ୍ଦେଶ ଗୋପକଙ୍କ ପସନ୍ଦ ସହିତ। ଛାଣକ ପାଇଁ ଖୋଲାପିବା ପାଇଁ ଆପଣ ଗୋଟିଏ TimTim.Live ପରିଶୋଧ ସଂଯୋଗ ପାଇଛନ୍ତି; ଏହି ବିକ୍ରୟ ନିଜ କମ୍ପାନୀକୁ ସିଧାସଳଖ ରଖାଯାଇଥାଏ। ପରୀକ୍ଷଣ କି ବର୍ତ୍ତମାନ ଚେଷ୍ଟା କରିପାରିବ । ଜୀବନ୍ତ ବ୍ୟବହାର ପାଇଁ ଗୋଟିଏ TimTim.Live ପରୀକ୍ଷଣ ଆବଶ୍ୟକ ଏବଂ କାର୍ଡ ଅନୁପାତକୁ ସକ୍ରିୟ କରାଯାଇଛି ।

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

କାର୍ଡ-ସଂଯୋଗିତ ପ୍ରତିରୋଧ (ବ୍ୟାକ ଏବଂ ପୁରଣ ପ୍ରଗ୍ରାମ)

GET /v1/ ofers ପ୍ରତ୍ୟେକ ଘଟଣାକୁ ଦର୍ଶାଇଥାଏ ଯାହାକୁକି ପ୍ରତିଶୋଧ ନେଇ ପ୍ରସ୍ତୁତ ହେତୁ । ପ୍ରତ୍ୟେକ ପ୍ରଦାନରେ ଆୟୋଜକ ଅଛି, ଆପଣ ଯୋଡ଼ିପାରିବେ ଦିନ, ମୂଲ୍ୟ, ସ୍ଥାନ ଏବଂ ପୁରଣ । ଆପଣଙ୍କର ଗ୍ରାହକ ଏହାକୁ ଆପଣଙ୍କର ଅନୁସରଣ କରାଯାଇଥିବା ସଂଯୋଗ ମାଧ୍ଯମରେ ସକ୍ରିୟ କରିଥାଏ, ଏବଂ ପକ୍ଷା ଆପଣଙ୍କର କମ୍ପାନୀକୁ /v1/earnings ମାଧ୍ୟମରେ ଦେଖାଯାଇଥାଏ। କିଗୁଡିକର ପରୀକ୍ଷଣ ନମୁନା ପ୍ରଦାନଗୁଡ଼ିକୁ ଦେଖନ୍ତୁ । ଜୀବନ ପ୍ରଦାନର ଏକ TimTim.Live ପରୀକ୍ଷା ଆବଶ୍ୟକ ହୋଇଥାଏ। ମେଳଖାଉଥିବା କାର୍ଡ ଅନୁପାତ ସିଧାସଳଖ ଭାବରେ ଗୋଟିଏ କାର୍ଡ଼ ନେଟୱର୍କ କିମ୍ବା ବ୍ୟାକ ସହିତ ଗୋଟିଏ ରାଜ୍ୟ ଆବଶ୍ୟକ କରିଥାଏ, ଏବଂ ସଂଯୁକ୍ତ ନୁହଁ।

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

ଘଟଣା ସ୍ଥିତି ଏବଂ ବିକେଟଗୁଡ଼ିକ

ସ୍ଥିତି ସଜ୍ଜିକରଣ, ଅତିରିକ୍ତ, ପୁଣି ସମୟ ସୀମା, ବାତିଲ, seld_out କିମ୍ବା ସମ୍ପୂର୍ଣ୍ଣ ହୋଇଛି. tickets. ଉପଲବ୍ଧତା ଉପଲବ୍ୟ, ସୀମାିତ, seld_out, no_on_sale କିମ୍ବା ସମାପ୍ତ। ଗୋଟିଏ ଘଟଣା ବାତିଲ ହେଲେ, ଏହାକୁ ନିମ୍ନ ଆଣନ୍ତୁ।

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

ଆପଣ କେତେ ତୀବ୍ର ପଚାରିପାରିବେ

ପରୀକ୍ଷଣ କି: 60 ମିନିଟ ପାଇଁ ଅନୁରୋଧ କରିଥାଏ। ଜୀବନ୍ତ କିଗୁଡ଼ିକ: ଏକ ମିନିଟରେ 120 । ତୀବ୍ର ଗତି କରିବାକୁ 429 ଉତ୍ତର ପାରିବ ପରେ ପୁଣିଥରେ, ସେକଣ୍ଡ ସଂଖ୍ୟାକୁ ଅପେକ୍ଷା କରିବାକୁ ହେଉଛି।

ଆପଣ କେଉଁ ଘଟଣାକୁ ପାଇବେ

ଘଟଣା ୟାହାକି TimTim.Live ଆୟୋଜକ ତିଆରି ଏବଂ ସହଭାଗ କରିବା ପାଇଁ ବାଛି ଥାଏ। ଅନ୍ୟାନ୍ୟ ଟକେଟ ସାଇଟରୁ ଆୟତ କରାଯାଇଥିବା ଘଟଣାଗୁଡ଼ିକ ମଧ୍ଯକୁ ଅନ୍ତର୍ଭୁକ୍ତ କରାଯାଇପାରିବ ନାହିଁ, କାରଣ ସେମାନଙ୍କୁ ସହଭାଗ କରିବା ପାଇଁ ଆମର ଉପାୟ ନାହିଁ।

ଆପଣ କେବେ ପଠାଇପାରିବେ ନାହିଁ

ଗୁଣକାରୀ ନାମ, ଇମେଲ ଠିକଣା, ମୂଳ ଠିକଣା, ଫୋନ କ୍ରମ ସଂଖ୍ୟା ଏବଂ କାର୍ଡ ବିବରଣୀ। ସହଯୋଗୀ API ଘଟଣା ସୂଚନାକୁ ସହଭାଗ କରିଅଛି, ଆମ ସଦସ୍ଯ ନୁହଁ।

ୱେବସାଇଟ ୱିଜେଟComment

HTML ର ଗୋଟିଏ ରେଖା ଯେକୌଣସି ୱେବସାଇଟରେ ଘଟଣାଗୁଡ଼ିକୁ ପ୍ରଦର୍ଶନ କରିଥାଏ। ଗୋଟିଏ ୱେବସାଇଟ କି ବ୍ୟବହାର କରନ୍ତୁ (tt_pk_live_) ଏବଂ ଆପଣଙ୍କର ୱେପସାଇଟକୁ କିର ଅନୁମତିପତ୍ର ତାଲିକାରେ ଯୋଗ କରନ୍ତୁ। କୌଣସି କି ବିନା ଏହା ନମୁନା ଘଟଣାଗୁଡ଼ିକୁ ଦର୍ଶାଇଥାଏ।

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

ବିକଳ୍ପଗୁଡ଼ିକ: ତଥ୍ୟ ସହତା, ତଥ୍ୟ ଦେଶ, ତଥ୍ୟ ବିଭାଗ, ତଥ୍ୟ ସୀମା (1–24), ତଥ୍ୟ-earn="true", ତଥ୍ୟ-lang ଏବଂ ତଥ୍ୟ ରଙ୍ଗ।

OAuth 2.0 (ଆଧିକ ଏକତ୍ରିକରଣ)

ଇଚ୍ଛାଧୀନ. ଆପଣଙ୍କର ଡ୍ୟାସବୋର୍ଡରେ ଗୋଟିଏ OAuth କ୍ଲାଏଣ୍ଟ କରନ୍ତୁ। ଗୋଟିଏ ଘଣ୍ଟା ଦେଇଥିବା ଗୋଟିଏ ପ୍ରବେଶାନ ପାଇଁ ଏହାର କ୍ଲାଏଣ୍ଟ ID ଏବଂ ଗୁପ୍ତ ବ୍ୟବହୃତ କରନ୍ତୁ। କି ପରିବର୍ତ୍ତେ ଏହି ଟକେନକୁ ପଠାନ୍ତୁ। ଏହି ଗୁପ୍ତତା ଆପଣଙ୍କର API ଡ଼ାକ ସହିତ କଦାପି ନଥାଇପାରେ, ଏବଂ ଆପଣ କ୍ଲାଏଣ୍ଟ ଠାରୁ ଅଧିକ କ୍ଷେତ୍ର ପାଇଁ ପଚାର କରିପାରିବେ।

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

ଏକ ଟକେନକୁ ସୁରକ୍ଷିତ କରିବା ପାଇଁ, ଏହା ସମାନ କ୍ଲାଏଣ୍ଟ ID ଏବଂ ଗୋପନୀୟତା ସହିତ /v1/oauth/revoke କୁ ପ୍ରସ୍ତୁତ କରିବା ପାଇଁ। ଆପଣଙ୍କର ଡ୍ୟାସବୋର୍ଡରେ କ୍ଲାଏଣ୍ଟକୁ ଅଦ୍ୟତନ କରିବା ପାଇଁ ଏହାର ସମସ୍ତ ଟକେନ ଶେଷ ସମାପ୍ତ ହୋଇଥାଏ ।

ଆପଣଙ୍କ ସର୍ଭରଗୁଡ଼ିକ ପାଇଁ ଗୋଟିଏ କି ଅପରିବର୍ତ୍ତନୀୟ କରନ୍ତୁ

ଇଚ୍ଛାଧୀନ. ଆପଣଙ୍କର ଡ୍ୟାସବୋର୍ଡରେ, ଗୋଟିଏ ସର୍ଭର କି ଖୋଜନ୍ତୁ, କି ପରୀକ୍ଷଣ କି କି କି କି OAuth କ୍ଲାଏଣ୍ଟ। "ମୋର ସର୍ଭରଗୁଡ଼ିକ ପାଇଁ ଲକ ଖୋଲନ୍ତୁ" ଏବଂ ଆପଣଙ୍କର ସର୍ଭରର ସାର୍ବଜନୀନ ଠିକଣାଗୁଡ଼ିକୁ ତାଲିକା ଦିଅନ୍ତୁ। ଡ଼ାକ — ଏବଂ ଟକେନ ଅନୁରୋଧ — ଯେକୌଣସି ଉପାୟରୁ ବାରଣ କରାଯାଇଥାଏ ip_not_illated, ଠିକ କି ସହିତ ମଧ୍ଯ ।

ଗ୍ରାହକ ପ୍ରମାଣପତ୍ର (mTLS), ବଡ଼ ସମ୍ପାଦିନ ପାଇଁ: ଆପଣଙ୍କର ସର୍ଭରର ID କାର୍ଡ (ଏ ପ୍ରମାଣପତ୍ର) ଦିଅନ୍ତୁ ଏବଂ ଏହାକୁ ଗୋଟିଏ କିରେ ପପ କରନ୍ତୁ । ତାପରେ https://api.tim.trim.vive. ସେହି ପ୍ରମାଣପତ୍ରକୁ ଧାରଣ କରିଥିବା କେବଳ ସେବକକୁ ଉତ୍ତର ଦିଏ।

# 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 ପ୍ଲଗଇନ

WordPress ବ୍ୟବହାର କରନ୍ତି କି? TimTim.Live Events ଇନଷ୍ଟଲ୍ କରନ୍ତୁ: ଏକ ବ୍ଲକ୍ ଏବଂ ଏକ ସର୍ଟକୋଡ୍ ଯାହା ଆପଣଙ୍କ ନିଜ TimTim.Live ଟିକେଟ୍ ଲିଙ୍କ ସହ ଇଭେଣ୍ଟ ଦେଖାଏ। ଏହାକୁ TimTim.Live ତିଆରି କରିଛି, ଏହା କେବଳ timtim.live ସହ କଥା ହୁଏ, ଏବଂ କେବଳ timtim.live ରୁ ଅପଡେଟ୍ ହୁଏ।

Plugins → Add New → Upload Plugin ରେ ଫାଇଲ୍ ଅପଲୋଡ୍ କରନ୍ତୁ। Settings → TimTim.Live Events ରେ ଆପଣଙ୍କ ୱେବସାଇଟ୍ କି ପେଷ୍ଟ କରନ୍ତୁ ଏବଂ Test Connection ଦବାନ୍ତୁ। ତାପରେ ଯେକୌଣସି ପେଜରେ TimTim.Live Events ବ୍ଲକ୍ ଯୋଡ଼ନ୍ତୁ।

WordPress ପ୍ଲଗଇନକୁ ଆହରଣ କରନ୍ତୁ

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

ଶ୍ରୋତା

JSON Feed, RSS, XML, CSV କିମ୍ବା ଗୋଟିଏ କ୍ଯାଲେଣ୍ଡର ଫାଇଲ (.ics) ପରି ସମାନ ଘଟଣାଗୁଡ଼ିକ। Google କ୍ଯାଲେଣ୍ଡର, Apple କ୍ୟାଲେଣ୍ଡର ଏବଂ Outlook କ୍ୟାଲେଣ୍ଡରକୁ ସଦସ୍ୟତା ଗ୍ରହଣ କରିପାରିବ। ଫିକା ପାଠକଗୁଡ଼ିକୁ ଶୀର୍ଷକ ପଠାଇପାରିବ ନାହିଁ, ତେଣୁ ଗୋଟିଏ ୱେବସାଇଟ କି କି କି ?key= ରେ ପରୀକ୍ଷଣ କି ରଖନ୍ତୁ। ଗୋଟିଏ ସର୍ଭର କିକୁ ସଂଯୋଗରେ କଦାପି ରଖନ୍ତୁ ନାହିଁ।

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

ୱେବହୋକସName

ଆପଣଙ୍କର ଡ୍ୟାସବୋର୍ଡରେ ଗୋଟିଏ ଠିକଣା ଯୋଗ କରନ୍ତୁ ଏବଂ ଯେତେବେଳେ କିଛି ପରିବର୍ତ୍ତନ ହୋଇଥାଏ: ଘଟଣା.changed ଅଥବା ଚେତାବନୀ.changed.changd. ୱେବହୋକଗୁଡ଼ିକ ବୈକଳ୍ପିକ — ପରିବର୍ତ୍ତିତ (_h) ଆପଣଙ୍କୁ ସମାନ ସୂଚନା ଦେଇଥାଏ ।

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

ପ୍ରତ୍ୟେକ ସନ୍ଦେଶକୁ ଯାଞ୍ଚ କରନ୍ତୁ: ଏହା ଆପଣଙ୍କର ଗୋପନୀୟତା ସହିତ ହସ୍ତାକ୍ଷର ହୋଇଛି। ପାଞ୍ଚ ମିନଟରୁ ପୁରୁଣା କିଛି ମିଟରକୁ ବାରଣ କରନ୍ତୁ, ଏବଂ ଆପଣ ପୂର୍ବରୁ ଗୋଟିଏ TimTim-Delivery-Id ନିୟନ୍ତ୍ରଣ କରିଛନ୍ତି।

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

କିଛି 2xx ସହିତ 10 ସେକଣ୍ଡ ମଧ୍ଯରେ ଉତ୍ତର ଦିଅନ୍ତୁ। ଯଦି ନୁହେଁ, ତେବେ ଆମେ ୧ ମିନିଟ ପରେ, 5 ମିନଟ, 30 ମିନିଟ, ୨, 6, 12 ଏବଂ 24 ଘଣ୍ଟା, ତାପରେ ବନ୍ଦ କରନ୍ତୁ। ଆମେ କେବେ ପୁଣିଥରେ ଫଳାଫଳ ଦିଅନ୍ତୁ ନାହିଁ ।

ନେଟୱର୍କ

ପରୀକ୍ଷଣ ଚାବିଗୁଡିକ ନମୁନା ପରିକ୍ଷଣ କରାଯାଇଥିବା ଘଟଣାଗୁଡ଼ିକୁ ଚିହ୍ନଟ ହୋଇଥାଏ — କୌଣସି ପ୍ରକୃତ ମନୋନୀତ ନାହିଁ । ଗୋଟିଏ ନିର୍ଦ୍ଦେଶ ଖୋଲା, ପରୀକ୍ଷଣ ଟିକଟ କୁ ଦବାନ୍ତୁ, ତାପରେ ଆପଣଙ୍କର ଚେତାବନୀ ପାଇଁ ପଚାରନ୍ତୁ। ଫେରିବାକୁ ଅନୁକରଣ କରନ୍ତୁ ଏବଂ ଏହାକୁ ପ୍ରତ୍ୟାବୃତ କରିବାକୁ ଦିଅନ୍ତୁ ।

କିଛି ଭଲ ହେଲେ

ତ୍ରୁଟି ନିଜକୁ ସରଳ ଶବ୍ଦରେ ବ୍ୟାଖ୍ୟା କରନ୍ତୁ, ଏକ ଶୀର୍ଷକ ସହିତ ଏବଂ ପରବର୍ତ୍ତୀ କଣ କରାଯିବ । ପ୍ରତ୍ୟେକ ଉତ୍ତର ଗୋଟିଏ ଟିମଟିମ-ଉତ୍ସ-ଇଦ ଦେଇଥାଏ । ଆମକୁ ପଠାନ୍ତୁ ଏବଂ ଆମ ଆପଣଙ୍କର ଅନୁରୋଧକୁ ଖୋଜି ପାରିବ।

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.

ବ୍ୟବସ୍ଥା

ପ୍ରତ୍ୟେକ କ୍ଷେତ୍ରର ସମ୍ପୂର୍ଣ୍ଣ ବର୍ଣ୍‍ଣନା, OpenAPI ସଜ୍ଜିକରଣରେ ଆପଣଙ୍କର ସାଧନଗୁଡ଼ିକୁ ପଢ଼ିପାରିବ ।

opi.yaml ଆହରଣ କରନ୍ତୁ

ଜୀବନ୍ତ କି କି କି ଖୋଲାଅଛି

ଆପଣଙ୍କର ପରୀକ୍ଷଣ କି ତଳେ କାର୍ଯ୍ୟ କରେ । ଜୀବନ୍ତ କି ପାଇଁ, TimTim.Live ରେ ଜଣେ ବ୍ୟକ୍ତି ଆପଣଙ୍କର କମ୍ପାନୀ ନାମ, ଆପଣଙ୍କର ୱେବସାଇଟକୁ ଦେଖିଥାଏ ଏବଂ ଆପଣ ଘଟଣାଗୁଡ଼ିକୁ କିପରି ଦର୍ଶାଇବେ । ଆପଣ ଆପଣଙ୍କର ଡ୍ୟାସବୋର୍ଡରେ ଉତ୍ତର ଦେଖିଛନ୍ତି ।

TimTim.Live API ଅଦ୍ୟତନଗୁଡିକ

ସଂସ୍କରଣ ୧ କେବଳ ବୃଦ୍ଧି । ଆମ ନୂତନ ସଦସ୍ୟ ଯୋଡିଛନ୍ତି । ସେଠାରେ ଯେଉଁଠୁ ଅଛି ତାହାକୁ ଆମ କାଢ଼ିପାରିବେ ନାହିଁ କିମ୍ବା ପୁନଃ ନାମକରଣ କରିପାରିବେ ନାହିଁ।

2026-10-08 — ଘଟଣା ଉତ୍ତର ବର୍ତ୍ତମାନ ଗୋଟିଏ ETag ନେଇଥାଏ। ଯେତେବେଳେ କୌଣସି ପରିବର୍ତ୍ତନ ନାହିଁ ତେବେ ଶିଘ୍ର 304 ପାଇବା ପାଇଁ ଏହାକୁ ପଛକୁ ପଠାନ୍ତୁ। ଇଚ୍ଛାଧୀନ.
2026-10-08 — ୱେବସାଇଟ କି ବର୍ତ୍ତମାନ ପ୍ରତ୍ୟେକ ଆଜିକୁ ନିଜରେ ଗଣନ୍ତୁ, ତେଣୁ ବ୍ୟସ୍ତ ସାଇଟଗୁଡ଼ିକ କାର୍ଯ୍ୟ କରୁଛନ୍ତି। କୌଣସି କାର୍ଯ୍ୟ ଆବଶ୍ୟକ ନାହିଁ।
2026-10-07 — ଗ୍ରାହକ ପ୍ରମାଣପତ୍ର (mTLS) ଖୋଲାଅଛି: ଆପଣଙ୍କର ଡ୍ୟାସବୋର୍ଡରେ ଗୋଟିଏ କିରେ ଆପଣଙ୍କର ପ୍ରମାଣପତ୍ରକୁ ପିନ କରନ୍ତୁ । ଇଚ୍ଛାଧୀନ. କୌଣସି କାର୍ଯ୍ୟ ଆବଶ୍ୟକ ନାହିଁ।
2026-10-07 — ବୁଲଫିଡ: ଗୋଟିଏ ଫାଇଲରେ ଆପଣ ପ୍ରତ୍ୟେକ ଘଟଣାକୁ ପ୍ରଦର୍ଶନ କରିପାରିବ, GET /v1/bulk ରେ। ଇଚ୍ଛାଧୀନ. କୌଣସି କାର୍ଯ୍ୟ ଆବଶ୍ୟକ ନାହିଁ।
2026-10-07 — API ରେ ନିଜର ଠିକଣା ଅଛି: https://api.tim.live/v1. https://tim.liv/v1 କାର୍ଯ୍ୟକାରୀ କରୁଛି। କୌଣସି କାର୍ଯ୍ୟ ଆବଶ୍ୟକ ନାହିଁ।
2026-10-06 — tim.live/checkout ରେ ଆପଣଙ୍କର ନିଜର ବର୍ଣ୍ଣନାପୃଷ୍ଠା । ଇଚ୍ଛାଧୀନ. କୌଣସି କାର୍ଯ୍ୟ ଆବଶ୍ୟକ ନାହିଁ।
2026-10-06 — ଆପଣଙ୍କର ନିଜ ପ୍ରୟୋଗରେ ଟିକଟ ବିକଳନ କରନ୍ତୁ: GET /v1/events/EVENT_ID/tickets ଏବଂ POST /v1/orders. ଇଚ୍ଛାଧୀନ. କୌଣସି କାର୍ଯ୍ୟ ଆବଶ୍ୟକ ନାହିଁ।
2026-10-06 — /partners/status ରେ ଗୋଟିଏ ସାର୍ବଜନୀନ ସ୍ଥିତି ପୃଷ୍ଠା, ପ୍ରତ୍ୟେକ ମିନିଟ ଯାଞ୍ଚ କରାଯାଇଛି। କୌଣସି କାର୍ଯ୍ୟ ଆବଶ୍ୟକ ନାହିଁ।
2026-10-06 — ସମ୍ପୂର୍ଣ୍ଣତା ପାଇଁ ମାସିକ ଅଭିବ୍ୟକ୍ତି: GET /v1/ ସେଟେଲment. କୌଣସି କାର୍ଯ୍ୟ ଆବଶ୍ୟକ ନାହିଁ।
2026-10-06 — ପୁରାବର୍ତ୍ତି: ?sub_id=କୁ ଯୋଗ କରନ୍ତୁ ଗୋଟିଏ ଛାଣି ସଂଯୋଗରେ ଏବଂ ଆମ ତୁମେ ଫେରାଇ ପାଖି ପଠାଇଛୁ । ଇଚ୍ଛାଧୀନ. କୌଣସି କାର୍ଯ୍ୟ ଆବଶ୍ୟକ ନାହିଁ।
2026-10-06 — ବ୍ୟାଙ୍କଗୁଡ଼ିକ ପାଇଁ କାର୍ଡ-ସଂଯୋଗିତ ପ୍ରସ୍ତୁତ ଓ ପ୍ରଗ୍ରାମଗୁଡ଼ିକ: GET /v1/ofers। ଇଚ୍ଛାଧୀନ. କୌଣସି କାର୍ଯ୍ୟ ଆବଶ୍ୟକ ନାହିଁ।
2026-10-06 — Google କ୍ଯାଲେଣ୍ଡର, Apple କ୍ୟାଲେଣ୍ଡର ଏବଂ Outlook ପାଇଁ କ୍ଯାଲେଣ୍ଡର feed: /v1/feeds/events.ics. କୌଣସି କାର୍ଯ୍ୟ ଆବଶ୍ୟକ ନାହିଁ।
2026-10-06 — ଆପଣଙ୍କ ସେବକଗୁଡ଼ିକ ପାଇଁ ଗୋଟିଏ କି ଅପରିବର୍ତ୍ତନୀୟ କରନ୍ତୁ: IP ଅନୁମତି ତାଲିକାଗୁଡ଼ିକ, କ୍ଲାଏଣ୍ଟ ପ୍ରମାଣପତ୍ର (mTLS) api.tim.lim.viv. ଇଚ୍ଛାଧୀନ. କୌଣସି କାର୍ଯ୍ୟ ଆବଶ୍ୟକ ନାହିଁ।
2026-10-06 — ବଡ଼ ସଂସ୍କରଣ ପାଇଁ OAuth 2.0 ଗ୍ରାହକ ପ୍ରମାଣପତ୍ର: POST /v1/oauth/token ଏବଂ /v1/outh/revoke। କି କାର୍ଯ୍ୟ ଚାଲୁ ରଖନ୍ତି । କୌଣସି କାର୍ଯ୍ୟ ଆବଶ୍ୟକ ନାହିଁ।
2026-10-06 — WordPress ପ୍ଲଗଇନ 1.0.0: ଗୋଟିଏ ଖଣ୍ଡ, ଗୋଟିଏ ଛୋଟକୋଡ ଏବଂ ଗୋଟିଏ ବିନ୍ୟାସ ପୃଷ୍ଠା । ଏହା ତିମ.ଜୀବନ ଠାରୁ ନିଜକୁ ଅଦ୍ୟତନ କରିଛନ୍ତି। କୌଣସି କାର୍ଯ୍ୟ ଆବଶ୍ୟକ ନାହିଁ।
2026-10-06 — ୱେବସାଇଟ ୱିଜେଟ, JSON/RSS/XML/CSV feeds ଏବଂ webhooks (event.changed, profit. changed). କୌଣସି କାର୍ଯ୍ୟ ଆବଶ୍ୟକ ନାହିଁ।
2026-10-06 — ସାଥୀକ API v1: ଘଟଣାଗୁଡ଼ିକ, ଏକ ଘଟଣା, ଚେତାବନୀ, ଏବଂ ବ୍ଯାଖ୍ଯା ତାଲିକା। କୌଣସି କାର୍ଯ୍ୟ ଆବଶ୍ୟକ ନାହିଁ।