Παγκόσμια διανομή μουσικής: έρχεται σύντομα!

ΑρχικήΆκουΕξερεύνησε
Το TimTim.Live μου
Σύνδεση

Partner API — Γρήγορο ξεκίνημα

Η πρώτη σας σύνδεση χωράει σε μία οθόνη.

Δοκιμάστε το τώρα — χωρίς κλειδί, χωρίς εγγραφή

Ανοίξτε αυτή τη διεύθυνση στον browser σας. Θα δείτε αμέσως δοκιμαστικές εκδηλώσεις.

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

    Πάρτε ένα δοκιμαστικό κλειδί

    Συνδεθείτε, πείτε μας ποιος είστε και πατήστε Δημιουργία δοκιμαστικού κλειδιού. Ξεκινά με tt_test_ και βλέπει μόνο δοκιμαστικές εκδηλώσεις.

  2. 2

    Βρείτε εκδηλώσεις

    Ζητήστε εκδηλώσεις σε μια πόλη.

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

    Δείξτε την εκδήλωση

    Κάθε εκδήλωση έχει όνομα, ημερομηνία, τόπο, εικόνα, τιμή και έτοιμες ετικέτες για την κάρτα σας.

  4. 4

    Χρησιμοποιήστε το buy_url

    Χρησιμοποιήστε το buy_url που σας δίνουμε. Αυτό ήταν. Το TimTim.Live καταγράφει από πού ήρθε η πώληση μέσα σε αυτόν τον σύνδεσμο.

  5. 5

    Δείτε τα αποτελέσματα

    Δείτε πόσους ανθρώπους στείλατε, πόσα εισιτήρια πουλήθηκαν και τα κέρδη στον πίνακά σας, ή ζητήστε τα.

    GET https://api.timtim.live/v1/earnings

Κατάσταση TimTim.Live

Αναφορά

Πού στέλνετε τα αιτήματα

https://api.timtim.live/v1

Το κλειδί σύνδεσής σας

Στείλτε το κλειδί σας στην κεφαλίδα Authorization. Τα δοκιμαστικά κλειδιά (tt_test_) βλέπουν μόνο δοκιμαστικές εκδηλώσεις. Τα κλειδιά ιστότοπου (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
Ένα μέρος, για παράδειγμα near=Paris,FR.
limit
Πόσες εκδηλώσεις ανά σελίδα, από 1 έως 100 (20 αν δεν το ορίσετε).

Πείτε μου μόνο τι άλλαξε

Αποθηκεύστε την ώρα του τελευταίου συγχρονισμού σας και στείλτε τη ως changed_since. Παίρνετε μόνο εκδηλώσεις που άλλαξαν — μαζί με ακυρώσεις και εξαντλημένες παραστάσεις. Δεν χρειάζεται webhook. Οι εκδηλώσεις που πρέπει να σταματήσετε να δείχνετε έρχονται στη λίστα withdrawn.

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

Περισσότερες από μία σελίδες

Αν η απάντηση έχει next, στείλτε το πίσω ως cursor= για να πάρετε την επόμενη σελίδα. Όταν το next είναι άδειο, τα έχετε όλα.

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

Κέρδη

Κάθε εκδήλωση έχει earn. Αν το earn.eligible είναι false, η εκδήλωση δεν έχει ανταμοιβή — αξίζει όμως να τη δείξετε. Αν είναι true, το earn.description λέει τι παίρνετε, για παράδειγμα «$5 ανά εισιτήριο που πληροί τους όρους». Αν γίνει επιστροφή χρημάτων για την αγορά, η ανταμοιβή ακυρώνεται.

Μαζικά feed (όλα σε ένα αρχείο)

Αποθηκεύστε ένα μαζικό feed στον πίνακά σας και μετά κατεβάστε όλες τις εκδηλώσεις του σε ένα συμπιεσμένο αρχείο: GET /v1/bulk/FEED_ID.ndjson.gz ή .csv.gz, με το κλειδί διακομιστή σας. Προσθέστε ?changed_since= για μόνο ό,τι άλλαξε, μαζί με τις εκδηλώσεις που αφαιρέθηκαν. Τα δοκιμαστικά κλειδιά μπορούν να το δοκιμάσουν τώρα· η κανονική χρήση χρειάζεται έλεγχο από το 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/tickets για να δείτε τι πωλείται, και μετά στείλτε POST /v1/orders με την επιλογή του αγοραστή. Παίρνετε έναν σύνδεσμο πληρωμής 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/offers δίνει κάθε εκδήλωση που πληρώνει ανταμοιβή ως προσφορά: τον διοργανωτή, τις ημερομηνίες που μπορείτε να αγοράσετε, την τιμή, τον τόπο και την ανταμοιβή. Ο πελάτης σας την ενεργοποιεί μέσω του συνδέσμου σας με παρακολούθηση, και η ανταμοιβή πληρώνεται στην εταιρεία σας μέσω του /v1/earnings. Τα δοκιμαστικά κλειδιά βλέπουν δείγματα προσφορών. Οι πραγματικές προσφορές χρειάζονται έλεγχο από το TimTim.Live. Η άμεση αντιστοίχιση πληρωμών με κάρτα χρειάζεται συμφωνία με δίκτυο καρτών ή τράπεζα, και δεν είναι συνδεδεμένη.

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

Κατάσταση εκδήλωσης και εισιτήρια

Το status είναι scheduled, postponed, rescheduled, cancelled, sold_out ή completed. Το tickets.availability είναι available, limited, sold_out, not_on_sale ή ended. Όταν μια εκδήλωση ακυρωθεί, αφαιρέστε τη.

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

Πόσο γρήγορα μπορείτε να ρωτάτε

Δοκιμαστικά κλειδιά: 60 αιτήματα το λεπτό. Κλειδιά live: 120 το λεπτό. Αν πάτε πιο γρήγορα, παίρνετε απάντηση 429 με Retry-After, δηλαδή πόσα δευτερόλεπτα να περιμένετε.

Ποιες εκδηλώσεις παίρνετε

Εκδηλώσεις που δημιουργούν οι διοργανωτές του TimTim.Live και επιλέγουν να μοιραστούν. Εκδηλώσεις που φέραμε από άλλους ιστότοπους εισιτηρίων δεν περιλαμβάνονται ποτέ, γιατί δεν έχουμε το δικαίωμα να τις μοιραστούμε.

Τι δεν στέλνουμε ποτέ

Ονόματα αγοραστών, διευθύνσεις email, διευθύνσεις κατοικίας, αριθμούς τηλεφώνου και στοιχεία κάρτας. Το Partner API μοιράζεται πληροφορίες εκδηλώσεων, όχι τα μέλη μας.

Widget για ιστότοπους

Μία γραμμή 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>

Επιλογές: data-city, data-country, data-category, data-limit (1–24), data-earn="true", data-lang και data-color.

OAuth 2.0 (μεγάλες συνδέσεις)

Προαιρετικό. Φτιάξτε έναν πελάτη OAuth στον πίνακά σας. Μετά ανταλλάξτε το αναγνωριστικό και το μυστικό του με ένα διακριτικό πρόσβασης μίας ώρας, και στείλτε αυτό το διακριτικό αντί για κλειδί. Το μυστικό δεν ταξιδεύει ποτέ μαζί με τις κλήσεις API σας, και μπορείτε να ζητήσετε λιγότερα δικαιώματα (scopes) από όσα έχει ο πελάτης.

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

Για να τερματίσετε νωρίτερα ένα διακριτικό, στείλτε το με POST στο /v1/oauth/revoke με το ίδιο αναγνωριστικό πελάτη και μυστικό. Αν απενεργοποιήσετε τον πελάτη στον πίνακά σας, όλα τα διακριτικά του τελειώνουν μαζί.

Κλειδώστε ένα κλειδί στους διακομιστές σας

Προαιρετικό. Στον πίνακά σας, ανοίξτε το «Κλείδωμα στους διακομιστές μου» κάτω από ένα κλειδί διακομιστή, δοκιμαστικό κλειδί ή πελάτη OAuth και γράψτε τις δημόσιες διευθύνσεις των διακομιστών σας. Οι κλήσεις — και τα αιτήματα token — από οπουδήποτε αλλού απορρίπτονται με ip_not_allowed, ακόμη και με το σωστό κλειδί.

Πιστοποιητικά πελάτη (mTLS): συνδέστε το πιστοποιητικό πελάτη TLS σας με ένα κλειδί και μετά καλέστε το https://api.timtim.live με αυτό. Κάθε κλήση πρέπει να δείχνει αυτό το πιστοποιητικό· το TLS handshake αποδεικνύει ότι έχετε το ιδιωτικό του κλειδί.

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

Ανεβάστε το αρχείο στο Πρόσθετα → Προσθήκη νέου → Μεταφόρτωση πρόσθετου. Επικολλήστε το κλειδί ιστότοπου στο Ρυθμίσεις → TimTim.Live Events και πατήστε Test Connection. Μετά προσθέστε το μπλοκ TimTim.Live Events σε οποιαδήποτε σελίδα.

Κατεβάστε το πρόσθετο WordPress
[timtim_events city="Washington" category="music" limit="6"]

Feed

Οι ίδιες εκδηλώσεις ως JSON Feed, RSS, XML, CSV ή ως ημερολόγιο (.ics), στο οποίο μπορούν να εγγραφούν τα Google Calendar, Apple Calendar και Outlook. Οι εφαρμογές ανάγνωσης feed δεν μπορούν να στείλουν κεφαλίδες, γι' αυτό βάλτε ένα κλειδί ιστότοπου ή ένα δοκιμαστικό κλειδί στο ?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

Webhooks

Προσθέστε μια διεύθυνση στον πίνακα ελέγχου σας και θα της στέλνουμε μήνυμα όταν κάτι αλλάζει: event.changed ή earnings.changed. Τα webhooks είναι προαιρετικά — το changed_since σας δίνει τις ίδιες πληροφορίες.

{
  "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 δευτερόλεπτα. Αν όχι, ξαναδοκιμάζουμε μετά από 1 λεπτό, 5 λεπτά, 30 λεπτά, μετά 2, 6, 12 και 24 ώρες, και μετά σταματάμε. Δεν ακολουθούμε ποτέ ανακατευθύνσεις.

Το sandbox

Τα δοκιμαστικά κλειδιά παίρνουν δοκιμαστικές εκδηλώσεις με την ένδειξη ΔΟΚΙΜΑΣΤΙΚΗ ΕΚΔΗΛΩΣΗ — ΟΧΙ ΑΛΗΘΙΝΑ ΧΡΗΜΑΤΑ. Ανοίξτε ένα buy_url, πατήστε Αγορά δοκιμαστικού εισιτηρίου και μετά ζητήστε τα κέρδη σας. Δοκιμάστε μια επιστροφή χρημάτων και δείτε την ακύρωση.

Όταν κάτι πάει στραβά

Τα σφάλματα εξηγούνται με απλά λόγια, με έναν τίτλο και τι να κάνετε μετά. Κάθε απάντηση έχει ένα TimTim-Request-Id. Στείλτε το σε εμάς και μπορούμε να βρούμε το αίτημά σας.

  • 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.

Η σύμβαση

Η πλήρης περιγραφή κάθε πεδίου, σε μορφή OpenAPI που διαβάζουν τα εργαλεία σας.

Λήψη openapi.yaml

Πώς ανοίγουν τα πραγματικά κλειδιά

Το δοκιμαστικό κλειδί σας λειτουργεί αμέσως. Για τα πραγματικά κλειδιά, ένας άνθρωπος στο TimTim.Live κοιτάζει το όνομα της εταιρείας σας, τον ιστότοπό σας και πώς θα δείχνετε τις εκδηλώσεις. Βλέπετε την απάντηση στον πίνακά σας.

Ενημερώσεις API του TimTim.Live

Η έκδοση 1 μόνο μεγαλώνει. Προσθέτουμε νέα πράγματα. Δεν αφαιρούμε και δεν μετονομάζουμε ό,τι υπάρχει ήδη.

  • — Οι απαντήσεις για εκδηλώσεις έχουν πλέον ETag. Στείλτε το πίσω στο If-None-Match για να πάρετε ένα γρήγορο 304 όταν δεν άλλαξε τίποτα. Προαιρετικό.
  • — Τα κλειδιά ιστότοπου μετρούν πλέον κάθε επισκέπτη χωριστά, ώστε οι πολυσύχναστοι ιστότοποι να συνεχίζουν να λειτουργούν. Δεν χρειάζεται να κάνετε τίποτα.
  • — Τα πιστοποιητικά πελάτη (mTLS) άνοιξαν: συνδέστε το πιστοποιητικό σας με ένα κλειδί στον πίνακά σας. Προαιρετικό. Δεν χρειάζεται να κάνετε τίποτα.
  • — Μαζικά feed: κάθε εκδήλωση που μπορείτε να δείξετε, σε ένα αρχείο, στο GET /v1/bulk. Προαιρετικό. Δεν χρειάζεται να κάνετε τίποτα.
  • — Το API έχει δική του διεύθυνση: https://api.timtim.live/v1. Το https://timtim.live/v1 συνεχίζει να λειτουργεί. Δεν χρειάζεται καμία ενέργεια.
  • — Η δική σας σελίδα πληρωμής με το δικό σας σήμα στο timtim.live/checkout. Προαιρετικό. Δεν χρειάζεται να κάνετε τίποτα.
  • — Πουλήστε εισιτήρια στη δική σας εφαρμογή: GET /v1/events/EVENT_ID/tickets και POST /v1/orders. Προαιρετικό. Δεν χρειάζεται να κάνετε τίποτα.
  • — Μια δημόσια σελίδα κατάστασης στο /partners/status, που ελέγχεται κάθε λεπτό. Δεν χρειάζεται να κάνετε τίποτα.
  • — Μηνιαίες καταστάσεις για εταιρείες: GET /v1/settlements. Δεν χρειάζεται να κάνετε τίποτα.
  • — Postbacks: προσθέστε ?sub_id= σε έναν σύνδεσμο αγοράς και σας το στέλνουμε πίσω μαζί με την πώληση. Προαιρετικό. Δεν χρειάζεται να κάνετε τίποτα.
  • — Προσφορές συνδεδεμένες με κάρτα για τράπεζες και προγράμματα ανταμοιβών: GET /v1/offers. Προαιρετικό. Δεν χρειάζεται να κάνετε τίποτα.
  • — Ροή ημερολογίου: /v1/feeds/events.ics για Google Calendar, Apple Calendar και Outlook. Δεν χρειάζεται να κάνετε τίποτα.
  • — Κλειδώστε ένα κλειδί στους διακομιστές σας: λίστες επιτρεπόμενων IP τώρα, πιστοποιητικά πελάτη (mTLS) στο api.timtim.live. Προαιρετικό. Δεν χρειάζεται να κάνετε τίποτα.
  • — OAuth 2.0 client credentials για μεγάλες συνδέσεις: POST /v1/oauth/token και /v1/oauth/revoke. Τα κλειδιά συνεχίζουν να λειτουργούν. Δεν χρειάζεται να κάνετε κάτι.
  • — Πρόσθετο WordPress 1.0.0: ένα μπλοκ, ένας σύντομος κώδικας και μια σελίδα ρυθμίσεων. Ενημερώνεται μόνο του από το timtim.live. Δεν χρειάζεται να κάνετε κάτι.
  • — Widget για ιστότοπους, feed JSON/RSS/XML/CSV και webhooks (event.changed, earnings.changed). Δεν χρειάζεται να κάνετε κάτι.
  • — Partner API v1: εκδηλώσεις, μία εκδήλωση, κέρδη και το sandbox. Δεν χρειάζεται να κάνετε κάτι.

Ο Σκοπός μας

Να Αφήσουμε τον Κόσμο Καλύτερο απ’ ό,τι τον Βρήκαμε

Καλούμε όλους να βοηθήσουν να αφήσουμε μια κληρονομιά για την ανθρωπότητα.

Γίνε Μέρος Τριών Αποστολών που θα Ζήσουν Περισσότερο από Όλους μας

Σπίτι

🏠 Σπίτι

Χτίσε Ελπίδα

Βοήθησε κάθε οικογένεια να έχει ένα μέρος να το λέει σπίτι — με χρηματοδότηση από το OseloHelp.com, τον αφορολόγητο μη κερδοσκοπικό μας οργανισμό.

Μνήμη

🎵 Μνήμη

Διαφύλαξε την Ανθρωπότητα μέσα από τη Μουσική

Διαφύλαξε τη μουσική και τις ιστορίες της ανθρωπότητας για τα επόμενα 1.000+ χρόνια.

Μέλλον

🚀 Μέλλον

Ενέπνευσε την Επόμενη Γενιά Εξερευνητών

Κάνε την ευκαιρία να εξερευνήσουμε το διάστημα διαθέσιμη σε όλους.

Τεχνικό διάγραμμα της ιδέας AdMerk Spacecraft

Το διαστημικό όχημα που σχεδιάζουμε

Ο σχεδιασμός ενός διαστημικού αεροσκάφους που απογειώνεται από διάδρομο αντί να εκτοξεύεται με πύραυλο. Είναι μια ιδέα, όχι ολοκληρωμένο όχημα.

Δείτε πώς λειτουργεί

Πώς συνδέονται όλα

Ο Κύκλος του TimTim.Live

Τίποτα εδώ δεν είναι ξεχωριστή επιχείρηση — κάθε στάδιο δυναμώνει το επόμενο.

  1. 🎵Μουσική & Δημιουργοί
  2. 🌍Παγκόσμια Κοινότητα
  3. 💰Έσοδα
  4. 🏠Προσιτά Σπίτια
  5. 📜Διαφύλαξη Πολιτισμού
  6. 🚀Τεχνολογίες του Μέλλοντος
  7. 📖Περισσότερες Ιστορίες
  8. 🎶Περισσότερη Μουσική

Ένας σκοπός. Πολλές επιχειρήσεις που στηρίζουν η μία την άλλη.

  1. 1Η μουσική δημιουργεί κοινότητα.
  2. 2Η κοινότητα δημιουργεί εμπιστοσύνη.
  3. 3Η εμπιστοσύνη στηρίζει το εμπόριο.
  4. 4Το εμπόριο χρηματοδοτεί μακροπρόθεσμες αποστολές.
  5. 5Οι μακροπρόθεσμες αποστολές δημιουργούν ιστορίες που αξίζει να μοιραστείς.
  6. 6Αυτές οι ιστορίες φέρνουν ακόμη περισσότερη κοινότητα.

Γίνε Μέρος της Κληρονομιάς

Είτε ακούς ένα τραγούδι, είτε μοιράζεσαι μια ιστορία, φοράς τα προϊόντα, πας σε μια συναυλία, μεταφράζεις στίχους, προτείνεις μια χώρα ή απλώς το λες σε έναν φίλο — γίνεσαι μέρος από κάτι φτιαγμένο να κρατήσει για γενιές.

Όλοι μπορούν να συμμετέχουν. Καμία συμβολή δεν είναι μικρή.

TimTim.Live — Εξερεύνησε τον Κόσμο μέσα από τη Μουσική.

Συνδέουμε ανθρώπους σε 195 χώρες, σήμερα με 3.004.605+ σελίδες καλλιτεχνών που φτάνουν έως 4+ εκατομμύρια · 8.684.002+ σελίδες επιχειρήσεων που φτάνουν έως 400 εκατομμύρια · ο ιστότοπος θα μεταφραστεί σε 417 τοπικές γλώσσες σε όλο τον κόσμο.

Το TimTim.Live ήδη χαρτογραφεί 233.839 τόπους σε όλες τις 195 χώρες και φτάνει σε κοινότητες με πληθυσμό μόλις 1.000 ανθρώπων, όπως:

257 πολιτείες • 1.690 επαρχίες • 4.808 κομητείες • 41.130 νομοί • 13.471 πόλεις • 117.896 κωμοπόλεις • 40.988 χωριά

© 2026 TimTim.Live. Με την επιφύλαξη παντός δικαιώματος.