Partner API — ፈጣን ጅምር

የመጀመሪያ ውህደትዎ በአንድ ስክሪን ይበቃል።

አሁኑኑ ይሞክሩ — ቁልፍ አያስፈልግም፣ መመዝገብ አያስፈልግም

ይህን አድራሻ በብራውዘርዎ ይክፈቱ። የናሙና ዝግጅቶችን ወዲያው ያያሉ።

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

1
የሙከራ ቁልፍ ያግኙ
ይግቡ፣ ማን እንደሆኑ ይንገሩን፣ እና "የሙከራ ቁልፍ ፍጠር" ን ይጫኑ። በtt_test_ ይጀምራል፣ የናሙና ዝግጅቶችን ብቻ ያያል።

ዝግጅቶችን ያግኙ

በአንድ ከተማ ያሉ ዝግጅቶችን ይጠይቁ።

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

3
ዝግጅቱን ያሳዩ
እያንዳንዱ ዝግጅት ስም፣ ቀን፣ ቦታ፣ ምስል፣ ዋጋ እና ለካርድዎ የተዘጋጁ ጽሑፎች አሉት።
4
buy_url ን ይጠቀሙ
የምንሰጥዎትን buy_url ይጠቀሙ። ያ ብቻ ነው። TimTim.Live በዚያ ሊንክ ውስጥ ሽያጩን ለእርስዎ ይመዘግባል።
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: ለምሳሌ music፣ festival ወይም conference።
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"። ግዢው ገንዘቡ ከተመለሰ ሽልማቱ ይመለሳል።

የጅምላ ፊዶች (ሁሉም ነገር በአንድ ፋይል)

በዳሽቦርድዎ ላይ የጅምላ ፊድ ያስቀምጡ፣ ከዚያ የሚሸፍናቸውን ሁሉንም ዝግጅቶች በአንድ የታመቀ ፋይል ያውርዱ፦ 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 ነው። ዝግጅቱ cancelled ሲሆን ያውርዱት።

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

ምን ያህል በፍጥነት መጠየቅ ይችላሉ

የሙከራ ቁልፎች፦ በደቂቃ 60 ጥያቄዎች። የቀጥታ ቁልፎች፦ በደቂቃ 120። ከዚያ በፍጥነት ከሄዱ 429 መልስ ከRetry-After ጋር ያገኛሉ፣ ይህም የሚጠብቁትን የሰከንድ ብዛት ይነግራል።

የትኞቹን ዝግጅቶች ያገኛሉ

የTimTim.Live አዘጋጆች የሚፈጥሯቸውና ለማጋራት የሚመርጧቸው ዝግጅቶች። ከሌሎች የቲኬት ድረ-ገጾች ያመጣናቸው ዝግጅቶች በፍጹም አይካተቱም፣ ምክንያቱም እነሱን የማጋራት መብት የለንም።

በፍጹም የማንልከው

የገዢዎች ስሞች፣ የኢሜይል አድራሻዎች፣ የቤት አድራሻዎች፣ ስልክ ቁጥሮች እና የካርድ ዝርዝሮች። Partner API የዝግጅት መረጃን ያጋራል፣ አባሎቻችንን አይደለም።

የድረ-ገጽ ዊጀት

አንድ የ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 ደንበኛ (client) ስር "ለሰርቨሮቼ ብቻ ቆልፍ" ይክፈቱ እና የሰርቨሮችዎን ይፋዊ አድራሻዎች ይዘርዝሩ። ከሌላ ቦታ የሚመጡ ጥሪዎች — እና የ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 ብቻ ነው።

ፋይሉን በ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 ወይም Google Calendar፣ Apple Calendar እና Outlook ሊመዘገቡበት በሚችሉት የቀን መቁጠሪያ (.ics)። የፊድ አንባቢዎች ራስጌ መላክ አይችሉም። ስለዚህ የድረ-ገጽ ቁልፍ ወይም የሙከራ ቁልፍ በ?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

ዌብሁኮች

በዳሽቦርድዎ ላይ አድራሻ ያክሉ። የሆነ ነገር ሲለወጥ ወደዚያ መልእክት እንልካለን፦ event.changed ወይም earnings.changed። ዌብሁኮች ግዴታ አይደሉም — 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);
});

በ10 ሰከንድ ውስጥ በማንኛውም 2xx ይመልሱ። ካልሆነ ከ1 ደቂቃ፣ ከ5 ደቂቃ፣ ከ30 ደቂቃ በኋላ፣ ከዚያም ከ2፣ 6፣ 12 እና 24 ሰዓት በኋላ እንደገና እንሞክራለን፣ ከዚያም እናቆማለን። አቅጣጫ ማዞሪያዎችን በፍጹም አንከተልም።

የሙከራ ቦታው

የሙከራ ቁልፎች "የሙከራ ዝግጅት — እውነተኛ ገንዘብ የለም" የሚል ምልክት ያላቸው የናሙና ዝግጅቶችን ያገኛሉ። 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.

የAPI ውል

የእያንዳንዱ መስክ ሙሉ መግለጫ፣ መሣሪያዎችዎ ሊያነቡት በሚችሉት የOpenAPI ቅርጸት።

openapi.yaml ያውርዱ

እውነተኛ ቁልፎች እንዴት ይከፈታሉ

የሙከራ ቁልፍዎ ወዲያው ይሰራል። ለእውነተኛ ቁልፎች፣ በTimTim.Live ያለ አንድ ሰው የኩባንያዎን ስም፣ ድረ-ገጽዎን እና ዝግጅቶችን እንዴት እንደሚያሳዩ ይመለከታል። መልሱን በዳሽቦርድዎ ላይ ያያሉ።

የTimTim.Live API ዝመናዎች

ስሪት 1 የሚያድገው ብቻ ነው። አዳዲስ ነገሮችን እንጨምራለን። ያለውን አናስወግድም፣ ስሙንም አንቀይርም።

2026-10-08 — የዝግጅት መልሶች አሁን ETag ይይዛሉ። ምንም ካልተቀየረ ፈጣን 304 ለማግኘት በIf-None-Match መልሰው ይላኩት። አማራጭ ነው።
2026-10-08 — የድረ-ገጽ ቁልፎች አሁን እያንዳንዱን ጎብኚ ለብቻው ይቆጥራሉ፤ ስለዚህ ብዙ ጎብኚ ያላቸው ጣቢያዎች መስራታቸውን ይቀጥላሉ። ምንም ማድረግ አያስፈልግዎትም።
2026-10-07 — የደንበኛ ሰርተፊኬቶች (mTLS) ተከፍተዋል፦ በዳሽቦርድዎ ላይ ሰርተፊኬትዎን ከአንድ ቁልፍ ጋር ያያይዙ። አማራጭ ነው። ምንም ማድረግ አያስፈልግዎትም።
2026-10-07 — የጅምላ ፊዶች፦ ማሳየት የሚችሉት እያንዳንዱ ዝግጅት፣ በአንድ ፋይል፣ በGET /v1/bulk። አማራጭ ነው። ምንም ማድረግ አያስፈልግዎትም።
2026-10-07 — ኤፒአዩ የራሱ አድራሻ አለው፦ https://api.timtim.live/v1። https://timtim.live/v1 እንደበፊቱ ይሰራል። ምንም ማድረግ አያስፈልግም።
2026-10-06 — በtimtim.live/checkout ላይ የራስዎ ብራንድ ያለው የክፍያ ገጽ። አማራጭ ነው። ምንም ማድረግ አያስፈልግዎትም።
2026-10-06 — በራስዎ መተግበሪያ ቲኬት ይሽጡ፦ GET /v1/events/EVENT_ID/tickets እና POST /v1/orders። አማራጭ ነው። ምንም ማድረግ አያስፈልግዎትም።
2026-10-06 — በ/partners/status ላይ በየደቂቃው የሚፈተሽ ለሁሉም ክፍት የሆነ የሁኔታ ገጽ። ምንም ማድረግ አያስፈልግዎትም።
2026-10-06 — ለኩባንያዎች ወርሃዊ መግለጫዎች፦ GET /v1/settlements። ምንም ማድረግ አያስፈልግዎትም።
2026-10-06 — Postback፦ በግዢ ሊንክ ላይ ?sub_id= ይጨምሩ፤ ከሽያጩ ጋር መልሰን እንልክልዎታለን። አማራጭ ነው። ምንም ማድረግ አያስፈልግዎትም።
2026-10-06 — ለባንኮች እና ለሽልማት ፕሮግራሞች ከካርድ ጋር የተገናኙ ቅናሾች፦ GET /v1/offers። አማራጭ ነው። ምንም ማድረግ አያስፈልግዎትም።
2026-10-06 — የቀን መቁጠሪያ ፊድ፦ /v1/feeds/events.ics ለGoogle Calendar፣ Apple Calendar እና Outlook። ምንም ማድረግ አያስፈልግዎትም።
2026-10-06 — ቁልፍን ለሰርቨሮችዎ ይቆልፉ፦ የIP ፍቃድ ዝርዝሮች አሁን፣ የደንበኛ ሰርተፊኬቶች (mTLS) በapi.timtim.live ላይ። አማራጭ ነው። ምንም ማድረግ አያስፈልግዎትም።
2026-10-06 — ለትላልቅ ውህደቶች OAuth 2.0 client credentials፦ POST /v1/oauth/token እና /v1/oauth/revoke። ቁልፎች መስራታቸውን ይቀጥላሉ። ምንም ማድረግ አያስፈልግዎትም።
2026-10-06 — የWordPress ፕለጊን 1.0.0፦ አንድ ብሎክ፣ አንድ ሾርትኮድ እና የቅንብሮች ገጽ። ራሱን ከtimtim.live ያዘምናል። ምንም ማድረግ አያስፈልግዎትም።
2026-10-06 — የድረ-ገጽ ዊጀት፣ JSON/RSS/XML/CSV ፊዶች እና ዌብሁኮች (event.changed, earnings.changed)። ምንም ማድረግ አያስፈልግዎትም።
2026-10-06 — Partner API v1፦ ዝግጅቶች፣ አንድ ዝግጅት፣ ገቢዎች እና የሙከራ ቦታው። ምንም ማድረግ አያስፈልግዎትም።