Isi Saya ingin … Pilih rencanamu; di bawahnya hanya langkah-langkah untuk itu. Referensi lengkap ada di bawah.
Buat bot di salah satu grupmu, di menu grup pada “Bot → Bot saya”, dengan gambar, nama, dan @nama. Tokennya hanya kamu lihat sekali. Bagikan tautan “Tambah bot” miliknya atau ajukan ke direktori bot, tempat bot muncul setelah diperiksa tim; siapa pun yang boleh mengelola peran di grup menerimanya dengan izin yang ia setujui. Terima apa yang terjadi di grupnya sebagai aliran (GET /v2/events/stream) atau di alamatmu, dan tulis dengan POST /v2/channels/{id}/messages. Selengkapnya di Bot . Daftarkan perintah (PUT /v2/me/commands) dan jawab dengan kartu dan tombol; bot memutar musik dengan tempat di kanal suara (POST /v2/channels/{id}/voice). Ringkasan v2 memungkinkan programmu sendiri berbicara dengan tellmelo: satu kunci per permintaan, JSON kembali, semua daftar berhalaman dengan cara yang sama. Aturannya sama seperti di aplikasi.
Setiap jalur diawali dengan https://api.tellmelo.com/v2. Permintaan dan jawaban berupa JSON dalam UTF-8. Nama field, kode, dan nilai berbahasa Inggris dan tetap berbahasa Inggris. Kunci bertindak sebagai akunmu: apa yang tidak bisa kamu lihat di aplikasi, tidak bisa dibacanya juga. https://api.tellmelo.com/v2Mulai cepat Buat kunci di “Area pengembang → API” dan salin. Kunci hanya ditampilkan sekali. Panggil root dengannya. Jawabannya menunjukkan versi, hak kunci, dan sisa permintaan menit ini. Setiap path bekerja dengan cara yang sama: kunci di header, JSON kembali, items dan next untuk daftar. curl -H "Authorization: Bearer tm_key_…" https://api.tellmelo.com/v2{
"name": "tellmelo",
"version": "2.20",
"scope": "read write",
"rateLimit": {
"limit": 120,
"remaining": 117
},
"docs": "/developers/docs",
"spec": "/api/v2/openapi.json"
}Berikutnya: /me untuk profilmu, /posts untuk postingan publik, /feed untuk feed-mu.
Coba Pilih tugas, isi kolomnya, lalu salin permintaan atau kirim dari sini. Penulisan meminta konfirmasi dulu. Kode membaca kunci dari TELLMELO_KEY.
Tugas GET / GET /posts GET /posts/{id} POST /posts DELETE /posts/{id} GET /me/scheduled POST /posts/{id}/schedule POST /posts/{id}/edit GET /posts/{id}/reply-settings PUT /posts/{id}/reply-settings POST /posts/{id}/coauthor DELETE /posts/{id}/coauthor POST /posts/{id}/pin GET /posts/{id}/replies POST /posts/{id}/replies POST /replies/{id}/edit DELETE /replies/{id} POST /replies/{id}/like POST /replies/{id}/vote POST /replies/{id}/pick GET /posts/{id}/replies/waiting POST /replies/{id}/decide GET /posts/{id}/replies/planned PUT /me/planned-replies/{id} POST /me/planned-replies/{id}/send DELETE /me/planned-replies/{id} POST /posts/{id}/vote GET /profiles/{handle} GET /profiles/{handle}/posts GET /profiles/{handle}/events POST /me/events PUT /me/events/{id} DELETE /me/events/{id} GET /me/events/{id}/signups POST /events/{id}/signup GET /communities GET /communities/{id} GET /communities/{id}/posts GET /communities/{id}/members GET /communities/{id}/roles GET /communities/{id}/bell GET /invites/{code} PUT /roles/{id}/self GET /communities/{id}/emojis PUT /communities/{id}/bell POST /invites/{code}/join GET /communities/{id}/bots GET /communities/{id}/channels GET /channels/{id}/messages POST /channels/{id}/messages POST /channels/{id}/read DELETE /channel-messages/{id} GET /communities/{id}/voice POST /communities/{id}/emojis DELETE /communities/{id}/emojis/{name} POST /communities/{id}/roles PUT /roles/{id} DELETE /roles/{id} PUT /communities/{id}/roles/order PUT /roles/{id}/members/{member} POST /communities/{id}/channels PUT /channels/{id} DELETE /channels/{id} PUT /communities/{id}/channels/order PUT /communities/{id}/channels/shape GET /channels/{id}/overrides PUT /channels/{id}/overrides/{role} POST /communities/{id}/categories PUT /categories/{id} DELETE /categories/{id} PUT /communities/{id}/feed GET /communities/{id}/invites POST /communities/{id}/invites DELETE /invites/{code} POST /channel-messages/{id}/remove POST /communities/{id}/posts/{post}/remove DELETE /communities/{id}/members/{member} PUT /communities/{id}/members/{member}/timeout DELETE /communities/{id}/members/{member}/timeout GET /communities/{id}/bans PUT /communities/{id}/bans/{member} DELETE /communities/{id}/bans/{member} GET /communities/{id}/log POST /communities PUT /communities/{id} GET /events GET /events/stream GET /me/commands PUT /me/commands POST /interactions/{id}/reply POST /channels/{id}/voice GET /tags GET /search GET /emojis GET /media GET /media/mine GET /media/{id} POST /media/uploads POST /media/{id} DELETE /media/{id} GET /me GET /feed POST /me/pictures PUT /me/profile GET /me/emojis POST /me/emojis/pictures POST /me/emojis DELETE /me/emojis/{name} PUT /me/emojis/sharing GET /me/webhooks POST /me/webhooks DELETE /me/webhooks/{id} POST /me/webhooks/{id}/test GET /notifications POST /notifications/read GET /conversations GET /conversations/{with}/messages POST /conversations/{with}/messages POST /conversations/{with}/read DELETE /conversations/{with}/messages/{id} POST /conversations/{with}/planned GET /me/planned-messages POST /me/planned-messages/{id}/send DELETE /me/planned-messages/{id} POST /relations GET /profiles/{handle}/followers GET /profiles/{handle}/following GET /me/relations GET /me/collections POST /me/collections PUT /me/collections/{id} DELETE /me/collections/{id} GET /me/collections/{id}/posts POST /me/collections/{id}/posts GET /partner/quota GET /partner/gifts POST /partner/gifts GET /gift-drops POST /gift-drops read Versi API dan nama instans ini.
curl JavaScript Python
curl \
-H "Authorization: Bearer $TELLMELO_KEY" \
"https://api.tellmelo.com/v2"Kuncimu Hingga 10 kunci per akun, masing-masing dengan nama, izin sendiri, dan jika mau tanggal kedaluwarsa. Kunci diawali tm_key_ dan hanya ditampilkan sekali. Hilang? Perbarui; nilai lama berhenti berfungsi.
Kamu membuatnya di “Area pengembang → API”. Kunci dikirim di header permintaan:
curl -H "Authorization: Bearer tm_key_…" \
https://api.tellmelo.com/v2/postsAtau, jika lebih praktis, di header tersendiri:
curl -H "X-Tellmelo-Key: tm_key_…" https://api.tellmelo.com/v2Jangan di URL: nanti tercatat di log dan riwayat peramban.
Kunci yang sama memuat gambar: setiap url mengarah ke /api/media; kirim kunci di header di sana juga.
curl -H "Authorization: Bearer tm_key_…" \
-o picture.webp "https://api.tellmelo.com/media?id=…"Apa yang boleh dilakukan kunci Sebuah kunci selalu bisa membaca dan, jika kamu izinkan, juga menulis, memberi hadiah, mengunggah media, dan mengelola grup. Setiap jalur di bawah menyebutkan apa yang dibutuhkannya:
read : membaca. Postingan publik, profil, grup, dan tag, serta feed, notifikasi, pesan, dan kanal grupmu.write : bertindak. Memposting, membalas, memilih, mengirim pesan, menulis di obrolan grup, mengikuti, bergabung, memblokir, menandai notifikasi sudah dibaca.gifts : memberi hadiah. Dari kuota seorang mitra ke anggota, dan hadiah di postingan baru. Izin tersendiri, supaya kunci untuk memposting tidak pernah bisa membagikan apa pun.media : perpustakaan media milikmu. Mengunggah, mengubah, membagikan, dan menghapus GIF dan video. Izin tersendiri, karena unggahan memakai poin video akun. Mencari GIF dan video yang dibagikan cukup dengan read .groups : mengelola grup. Peran, kanal, kategori, tautan undangan, kanal feed, penghapusan, pembisuan, pengeluaran, dan blokir, sejauh akunmu boleh di grup itu. Hak tersendiri, agar kunci untuk memposting tidak pernah mengubah siapa boleh apa di sebuah grup.Yang tidak bisa dilakukan kunci mana pun Tidak ada kunci yang menjangkau kata sandi, alamat email, jenis akun, tempat, peran, penghapusan, sesi, perangkat push, atau kunci lain, juga administrasi atau kepemimpinan grup. Apa yang dilindungi kata sandi, tidak bisa dilakukan kunci mana pun.
Bot Bot adalah akun tersendiri berjenis bot untuk grup: tanpa kata sandi dan email, dijalankan programmu dengan kuncinya sendiri. Ia memakai API yang sama dengan akun lain dan di grup bisa melakukan apa pun yang diizinkan perannya di sana.
Di salah satu grupmu, buka menu grup lalu di “Bot → Bot saya” buat bot dengan gambar, sampul, nama, nama pengguna, dan deskripsi. Token hanya ditampilkan sekali; token ini punya izin read, write, media, dan groups. Bagikan tautan bot atau ajukan ke direktori bot; bot muncul di sana begitu tim memeriksanya. Siapa pun yang boleh mengelola peran di grup memilih izinnya; bot bergabung dan mendapat peran sendiri. Programmu mengirim token sebagai Authorization: Bearer …, membaca peristiwa grupnya sebagai aliran, dan bekerja dengan rute di Bot , Kanal , dan Grup . Bot kecil yang membaca peristiwa sebagai aliran dan menjawab perintah /ping dengan pong, hanya untuk yang bertanya:
// Node 18 or newer: reads the events of the bot's groups as they happen and answers /ping.
const BASE = 'https://api.tellmelo.com/v2';
const KEY = process.env.TELLMELO_BOT_TOKEN;
const call = (method, path, body) =>
fetch(BASE + path, {
method,
headers: { Authorization: 'Bearer ' + KEY, 'Content-Type': 'application/json' },
body: body && JSON.stringify(body),
}).then((r) => r.json());
await call('PUT', '/me/commands', { commands: [{ name: 'ping', description: 'Answers pong' }] });
let last = '';
for (;;) {
// The stream closes after ten minutes; Last-Event-ID goes on where it stopped.
const res = await fetch(BASE + '/events/stream', {
headers: { Authorization: 'Bearer ' + KEY, ...(last && { 'Last-Event-ID': last }) },
});
const reader = res.body.pipeThrough(new TextDecoderStream()).getReader();
let buffer = '';
for (;;) {
const { value, done } = await reader.read();
if (done) break;
buffer += value;
let end;
while ((end = buffer.indexOf('
')) >= 0) {
const data = buffer.slice(0, end).split('
').find((l) => l.startsWith('data: '));
buffer = buffer.slice(end + 2);
if (!data) continue;
const event = JSON.parse(data.slice(6));
last = event.id;
if (event.type === 'command' && event.data.command === 'ping')
await call('POST', '/interactions/' + event.data.interaction + '/reply', { text: 'pong', private: true });
}
}
}Bot yang sama dalam Python, mengambil peristiwa halaman demi halaman:
# Python 3 with requests: the same bot, reading the events page by page.
import os, time, requests
BASE = 'https://api.tellmelo.com/v2'
H = {'Authorization': 'Bearer ' + os.environ['TELLMELO_BOT_TOKEN']}
requests.put(BASE + '/me/commands', headers=H,
json={'commands': [{'name': 'ping', 'description': 'Answers pong'}]})
since = '0'
while True:
page = requests.get(BASE + '/events', headers=H, params={'since': since}).json()
for event in page['items']:
if event['type'] == 'command' and event['data']['command'] == 'ping':
requests.post(f"{BASE}/interactions/{event['data']['interaction']}/reply",
headers=H, json={'text': 'pong'})
since = page['next'] or since
time.sleep(2)Apa yang boleh dilakukan bot di grup ditentukan oleh perannya di sana, bukan oleh token. Peran itu memakai namanya; grup mengubah izinnya di bagian peran pada pengaturan grup dan menghapus bot di menu grup pada “Bot → Di grup ini”. Hingga 5 bot per akun; per grup sebanyak yang diizinkan keuntungannya. Bot menulis paling banyak 30 pesan per menit per grup, tidak bisa ditemukan lewat pencarian, dan hanya menulis kepada yang lebih dulu menulis kepadanya. Batas berlaku. Peristiwa juga dikirim ke alamat HTTPS-mu sendiri (ditandatangani seperti webhook, dengan pengulangan). Selain itu: perintah (PUT /v2/me/commands) dengan jawaban untuk semua atau hanya yang bertanya, kartu dan tombol dalam pesan, serta musik di kanal suara (POST /v2/channels/{id}/voice): semuanya di Bot . Halaman Setiap daftar menerima limit dan cursor dan menjawab dengan items dan next. Kirim next kembali sebagai cursor untuk halaman berikutnya; jika next kosong, selesai. Kursor bersifat buram: jangan diurai, jangan dibuat sendiri.
{ "items": [ … ], "next": "MTc1ODYyNDAwMDAwMDo1ZjBjMmE5ZS04ZDQx" }
curl -H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/posts?limit=20&cursor=MTc1ODYyNDAwMDAwMDo1ZjBjMmE5ZS04ZDQx"Tanpa limit, 20 entri, maksimal 50. Beberapa daftar tidak berhalaman; next-nya selalu null.
Hanya yang baru Setiap jawaban membawa ETag. Kirim kembali sebagai If-None-Match lain kali: jika tidak ada yang berubah, kamu mendapat 304 tanpa isi.
ETag: W/"3Qk1mJ7fQe2Yb0sVxT9aL4pNdRc"
If-None-Match: W/"3Qk1mJ7fQe2Yb0sVxT9aL4pNdRc" → 304Pengecualian: /feed tidak punya ETag karena urutannya terus berubah, dan penulisan tidak pernah menjawab 304.
Batas Satu kunci boleh membuat 120 permintaan per menit, 600 dengan paket “Organisasi”, kecuali administrasi menetapkan lain. Di atas itu kamu mendapat 429 dan tidak ada yang dijalankan. Tunggu satu menit dan kirim lagi.
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 117
X-RateLimit-Reset: 1758624060Penulisan juga dihitung terhadap batas aplikasi, misalnya berapa postingan dalam beberapa menit. Itu juga menjawab 429 dengan rate_limited.
Saat sesuatu tidak berhasil Galat datang sebagai JSON: kode bahasa Inggris tetap di error untuk programmu dan kalimat di message untuk manusia, ditambah kode status yang sesuai. Bandingkan hanya kodenya; kalimatnya bisa berubah.
{ "error": "rate_limited",
"message": "Too many requests. Try again in a minute.",
"limit": 120 }Beberapa galat membawa satu field lagi: docs pada 401 karena kunci tidak ada, limit pada 429.
Status Kode Arti 400bad_requestPermintaan tidak terbaca, field wajib tidak ada, atau nilainya tidak diizinkan. 401key_missingTidak ada kunci di header. 401key_invalidKuncinya tidak valid: salah ketik, sudah diganti, atau akunnya dilarang. 401unauthorizedDitolak sebagai belum masuk, karena alasan selain kunci. 403scope_missingKunci tidak punya hak yang diperlukan, biasanya write. 403account_data_lockedData akun seperti kata sandi, alamat email, atau penghapusan tidak bisa dijangkau kunci. 403forbiddenAkunmu tidak boleh melakukan ini, misalnya karena hak dicabut atau blokir. 403timed_outPembisuan sedang membisukan akunmu di grup ini. 404unknown_pathPath ini tidak ada, atau tidak dengan metode ini. 404not_foundTidak ditemukan, atau kamu tidak boleh melihatnya. 409conflictBertabrakan dengan yang sudah ada, misalnya nama yang sudah dipakai. 409feed_offKanal feed grup ini sedang mati. 413too_largeTerlalu besar untuk instans ini. 422unprocessableTerbaca, tetapi tidak mungkin dalam bentuk ini. 429rate_limitedTerlalu banyak permintaan. Tidak terjadi apa-apa; tunggu dan coba lagi. 500internal_errorAda yang salah di server.
Versi Versinya ada di path. Selama tertulis v2, path dan field tetap sama; hanya ada tambahan baru.
Tambahan menaikkan angka kedua. Setiap path menyebutkan sejak kapan ada.
https://api.tellmelo.com/v1/ sudah tidak ada: path lama menjawab 410 dan menyebut cara baru di isinya.
Endpoint Semua path sekilas, lalu masing-masing dengan contoh.
Path Hak Untuk apa Jalan masuk GET /v2readVersi API dan nama instans ini. Postingan GET /v2/postsreadPostingan publik, yang terbaru lebih dulu. GET /v2/posts/{id}readSatu postingan, menurut id-nya. POST /v2/postswriteTerbitkan postingan. DELETE /v2/posts/{id}writeHapus salah satu postinganmu sendiri. GET /v2/me/scheduledreadPostinganmu yang belum tayang, dan apa yang sedang ditunggunya. POST /v2/posts/{id}/schedulewriteMengubah kapan postingan terjadwal tayang, atau kapan postingan terhapus sendiri. POST /v2/posts/{id}/editwriteMengubah teks salah satu postinganmu. GET /v2/posts/{id}/reply-settingsreadSiapa yang boleh membalas postinganmu, apakah balasan menunggu persetujuan, dan mode lambat. PUT /v2/posts/{id}/reply-settingswriteMengubah pengaturan balasan postinganmu. Yang tidak kamu isi tetap sama. POST /v2/posts/{id}/coauthorwriteMenerima atau menolak undangan sebagai rekan penulis. DELETE /v2/posts/{id}/coauthorwriteMundur sebagai rekan penulis, atau sebagai penulis mengeluarkan rekan penulis dari postingan. POST /v2/posts/{id}/pinwriteMenyematkan postinganmu di atas profil, atau melepasnya. Balasan GET /v2/posts/{id}/repliesreadBalasan untuk sebuah postingan, tanpa akun yang diblokir. POST /v2/posts/{id}/replieswriteBalas sebuah postingan. POST /v2/replies/{id}/editwriteMengubah teks salah satu balasanmu. DELETE /v2/replies/{id}writeMenghapus salah satu balasanmu. POST /v2/replies/{id}/likewriteBeri suara naik untuk balasan (suka adalah suara naik sejak balasan diberi suara) atau tarik kembali; suara turun tetap. POST /v2/replies/{id}/votewriteMemberi suara naik atau turun pada sebuah balasan, atau menarik suaramu. Menjawab dengan suaramu dan skor sesudahnya. POST /v2/replies/{id}/pickwriteMenyorot satu balasan di postinganmu sebagai yang terbaik, atau mencabut sorotan. GET /v2/posts/{id}/replies/waitingreadBalasan yang menunggu persetujuan di sebuah postingan: semuanya di postinganmu, selain itu hanya milikmu. POST /v2/replies/{id}/decidewriteMenyetujui atau menolak balasan yang menunggu di postinganmu. Yang ditolak akan dihapus. GET /v2/posts/{id}/replies/plannedreadBalasanmu yang dijadwalkan untuk nanti di sebuah postingan. PUT /v2/me/planned-replies/{id}writeMengubah teks atau waktu balasan terjadwal. Yang gagal akan menunggu lagi. POST /v2/me/planned-replies/{id}/sendwriteMengirim balasan terjadwal sekarang juga. DELETE /v2/me/planned-replies/{id}writeMenghapus balasan terjadwal. Jajak pendapat POST /v2/posts/{id}/votewriteIkut dalam jajak pendapat. Profil GET /v2/profiles/{handle}readSebuah profil, menurut nama pendeknya. GET /v2/profiles/{handle}/postsreadPostingan publik dari satu profil, yang terbaru lebih dulu. GET /v2/profiles/{handle}/eventsreadAcara mendatang dari sebuah profil, yang terdekat dulu. POST /v2/me/eventswriteMembuat acara. Menjawab dengan id-nya. PUT /v2/me/events/{id}writeMengubah salah satu acaramu. Semua kolom diatur ulang. DELETE /v2/me/events/{id}writeMenghapus salah satu acaramu. GET /v2/me/events/{id}/signupsreadSiapa yang mendaftar ke salah satu acaramu. POST /v2/events/{id}/signupwriteMendaftar ke acara atau membatalkannya. Grup GET /v2/communitiesreadGrup terbuka di instance ini; dengan mine=true, grup milik akunmu. GET /v2/communities/{id}readSatu grup, menurut id-nya. GET /v2/communities/{id}/postsreadPostingan kanal feed sebuah grup, terbaru dulu. GET /v2/communities/{id}/membersreadAnggota sebuah grup beserta perannya. GET /v2/communities/{id}/rolesreadPeran sebuah grup, yang tertinggi dulu, @everyone terakhir. GET /v2/communities/{id}/bellreadNotifikasi apa yang dikirim sebuah grup kepadamu. GET /v2/invites/{code}readGrup di balik tautan undangan, sebelum bergabung. PUT /v2/roles/{id}/selfwriteMengambil atau melepas peran pilihan sendiri. GET /v2/communities/{id}/emojisreadEmoji milik sebuah grup. PUT /v2/communities/{id}/bellwriteMengatur notifikasi apa yang dikirim sebuah grup kepadamu. POST /v2/invites/{code}/joinwriteBergabung ke grup dengan tautan undangan. GET /v2/communities/{id}/botsreadBot sebuah grup beserta apa yang diizinkan perannya. Kanal GET /v2/communities/{id}/channelsreadKanal sebuah grup yang kamu lihat, sesuai urutannya. GET /v2/channels/{id}/messagesreadPesan di kanal obrolan, terbaru dulu. POST /v2/channels/{id}/messageswriteMenulis pesan di kanal obrolan. POST /v2/channels/{id}/readwriteMenandai kanal obrolan sudah dibaca hingga suatu waktu. DELETE /v2/channel-messages/{id}writeMenghapus pesanmu sendiri di kanal obrolan. GET /v2/communities/{id}/voicereadSiapa yang sedang ada di saluran suara sebuah grup, per saluran. Mengelola grup POST /v2/communities/{id}/emojisgroupsMenambahkan emoji ke grup. DELETE /v2/communities/{id}/emojis/{name}groupsMenghapus emoji dari grup. POST /v2/communities/{id}/rolesgroupsMembuat peran. PUT /v2/roles/{id}groupsMengubah nama, warna, dan hak sebuah peran. DELETE /v2/roles/{id}groupsMenghapus peran. PUT /v2/communities/{id}/roles/ordergroupsMenetapkan urutan peran. PUT /v2/roles/{id}/members/{member}groupsMemberi atau mencabut peran seorang anggota. POST /v2/communities/{id}/channelsgroupsMembuat kanal obrolan. PUT /v2/channels/{id}groupsMengubah nama, topik, dan kategori sebuah kanal. DELETE /v2/channels/{id}groupsMenghapus kanal obrolan beserta pesannya. PUT /v2/communities/{id}/channels/ordergroupsMenetapkan urutan kategori dan kanal obrolan. PUT /v2/communities/{id}/channels/shapegroupsMenetapkan bentuk semua simbol kanal grup. GET /v2/channels/{id}/overridesgroupsApa yang boleh dilakukan peran secara berbeda di sebuah kanal dibanding di grup. PUT /v2/channels/{id}/overrides/{role}groupsMenetapkan apa yang boleh dilakukan peran secara berbeda di sebuah kanal. POST /v2/communities/{id}/categoriesgroupsMembuat kategori untuk kanal. PUT /v2/categories/{id}groupsMengganti nama kategori. DELETE /v2/categories/{id}groupsMenghapus kategori. PUT /v2/communities/{id}/feedgroupsMenyalakan atau mematikan kanal feed sebuah grup. GET /v2/communities/{id}/invitesgroupsTautan undangan sebuah grup yang masih berlaku. POST /v2/communities/{id}/invitesgroupsMembuat tautan undangan. DELETE /v2/invites/{code}groupsMenarik tautan undangan. POST /v2/channel-messages/{id}/removegroupsMenghapus pesan anggota lain dari sebuah kanal. POST /v2/communities/{id}/posts/{post}/removegroupsMenghapus postingan dari sebuah grup. DELETE /v2/communities/{id}/members/{member}groupsMengeluarkan anggota dari grup. PUT /v2/communities/{id}/members/{member}/timeoutgroupsMembisukan anggota. DELETE /v2/communities/{id}/members/{member}/timeoutgroupsMencabut pembisuan. GET /v2/communities/{id}/bansgroupsBlokir yang sedang berlaku di sebuah grup. PUT /v2/communities/{id}/bans/{member}groupsMemblokir anggota. DELETE /v2/communities/{id}/bans/{member}groupsMencabut blokir. GET /v2/communities/{id}/loggroupsLog pengurus: siapa menghapus apa dan mengapa. POST /v2/communitiesgroupsMendirikan grup. Menjawab dengan id-nya; kamu pendirinya. PUT /v2/communities/{id}groupsMengubah grup yang kamu pimpin. Yang tidak kamu isi tetap sama. Bot GET /v2/eventsreadPeristiwa dari grup bot sejak suatu peristiwa, halaman demi halaman. GET /v2/events/streamreadPeristiwa dari grup bot begitu terjadi (server-sent events). GET /v2/me/commandsreadPerintah bot. PUT /v2/me/commandswriteMenetapkan perintah bot, semuanya sekaligus. POST /v2/interactions/{id}/replywriteMenjawab perintah atau tombol. POST /v2/channels/{id}/voicewriteMengambil tempat di kanal suara untuk memutar musik atau suara. Jelajahi GET /v2/tagsreadTag yang sedang ramai. GET /v2/searchreadPencarian di postingan, nama, nama pendek, dan tag. GET /v2/emojisreadEmoji milik instans, dengan alamat gambarnya. GIF dan video GET /v2/mediareadGIF atau video yang dibagikan, yang paling sering dipakai lebih dulu. GET /v2/media/minemediaPerpustakaan media milikmu, yang terbaru lebih dulu. GET /v2/media/{id}readSebuah GIF atau video, milikmu atau yang dibagikan. POST /v2/media/uploadsmediaMulai unggahan. PUT /v2/media/uploads/{upload}mediaKirim satu potongan file. POST /v2/media/{id}mediaUbah salah satu GIF atau videomu. DELETE /v2/media/{id}mediaHapus salah satu GIF atau videomu. Akunmu GET /v2/mereadProfilmu sendiri, dengan id yang diharapkan path lain. GET /v2/feedreadFeed-mu sendiri, seperti yang disusun aplikasi. POST /v2/me/pictureswriteMengunggah gambar sebagai byte. Menjawab dengan id dan url; lalu id dipakai sebagai foto profil, sampul, atau di postingan. PUT /v2/me/profileprofileMengubah profilmu: nama, tentang kamu, foto profil, sampul, dan warna profil. Yang tidak kamu isi tetap sama. GET /v2/me/emojisreadEmoji milikmu sendiri. POST /v2/me/emojis/picturesprofileMengunggah gambar untuk emoji milikmu sebagai byte. POST /v2/me/emojisprofileMembuat emoji milikmu. Menjawab dengan semua emojimu. DELETE /v2/me/emojis/{name}profileMenghapus emoji milikmu. Menjawab dengan sisanya. PUT /v2/me/emojis/sharingprofileMenentukan apakah pengikutmu boleh memakai emojimu di teks mereka. GET /v2/me/webhookswebhooksWebhook-mu beserta statusnya. POST /v2/me/webhookswebhooksMembuat webhook. Menjawab dengan id dan rahasia untuk tanda tangan, hanya kali ini. DELETE /v2/me/webhooks/{id}webhooksMenghapus webhook. POST /v2/me/webhooks/{id}/testwebhooksMengirim uji coba ke webhook. Notifikasi GET /v2/notificationsreadNotifikasimu, yang terbaru lebih dulu. POST /v2/notifications/readwriteTandai notifikasimu sudah dibaca. Pesan GET /v2/conversationsreadKotak masukmu: satu baris per percakapan, yang terbaru lebih dulu. GET /v2/conversations/{with}/messagesreadPesan dalam satu percakapan, yang terbaru lebih dulu. POST /v2/conversations/{with}/messageswriteKirim pesan dalam percakapan. POST /v2/conversations/{with}/readwriteTandai semua pesan dalam percakapan sudah dibaca. DELETE /v2/conversations/{with}/messages/{id}writeMenghapus salah satu pesanmu. POST /v2/conversations/{with}/plannedwriteMenjadwalkan pesan untuk nanti. Menjawab dengan id pesan terjadwal. GET /v2/me/planned-messagesreadPesanmu yang masih akan dikirim, urut menurut waktu. POST /v2/me/planned-messages/{id}/sendwriteMengirim sekarang pesan terjadwal yang ditahan atau gagal. DELETE /v2/me/planned-messages/{id}writeMenghapus pesan terjadwal sebelum terkirim. Relasi POST /v2/relationswriteSuka, simpan, posting ulang, ikuti, gabung, blokir, bisukan, tergantung kind. GET /v2/profiles/{handle}/followersreadSiapa yang mengikuti sebuah profil, terbaru dulu. GET /v2/profiles/{handle}/followingreadSiapa yang diikuti sebuah profil, terbaru dulu. GET /v2/me/relationsreadSiapa yang kamu blokir, bisukan, atau blokir hanya untuk pesan, terbaru dulu. Koleksi GET /v2/me/collectionsreadKoleksimu beserta jumlah postingannya. POST /v2/me/collectionswriteMembuat koleksi. Menjawab dengan id-nya. PUT /v2/me/collections/{id}writeMengganti nama koleksi. DELETE /v2/me/collections/{id}writeMenghapus koleksi. GET /v2/me/collections/{id}/postsreadPostingan dalam sebuah koleksi, seperti di tab tersimpan. POST /v2/me/collections/{id}/postswriteMemasukkan postingan ke koleksi atau mengeluarkannya. Hadiah GET /v2/partner/quotareadSisa kuotamu untuk diberikan. GET /v2/partner/giftsreadApa yang kamu berikan dari kuota, kepada siapa dan kapan – yang terbaru dulu. POST /v2/partner/giftsgiftsMemberi bulan paket atau percikan dari kuotamu kepada anggota. GET /v2/gift-dropsreadHadiahmu di postingan: berapa tempat yang masih kosong dan bagaimana dibayar. POST /v2/gift-dropsgiftsMemposting postingan berisi hadiah untuk diambil orang lain.
Jalan masuk Permintaan pertama setiap program: apakah kuncinya berfungsi, dan apa yang boleh dilakukannya?
GET /v2Versi API dan nama instans ini.
Hak read dengan ETag sejak v2.0 Tanpa garis miring di akhir: https://api.tellmelo.com/v2/ dialihkan ke https://api.tellmelo.com/v2 dengan 308, dan tidak setiap program mengikutinya.
Contoh permintaan curl \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2"Jawaban Menjawab dengan satu Service
Contoh {
"name": "tellmelo",
"version": "2.20",
"scope": "read write",
"rateLimit": {
"limit": 120,
"remaining": 117
},
"docs": "/developers/docs",
"spec": "/api/v2/openapi.json"
}Status yang mungkin: 200304401429
Postingan Membaca postingan publik, menerbitkan milikmu sendiri, dan menghapusnya lagi.
GET /v2/postsPostingan publik, yang terbaru lebih dulu.
Hak read berhalaman dengan ETag sejak v2.0 Di path publik, counts.likes dan counts.reposts selalu 0 dan pinned bernilai false.
Postingan di grup tidak ada di sini, melainkan di /communities/{id}/posts.
Parameter Nama Tipe Arti limitdi query integeropsional Entri per halaman: 20 secara bawaan, maksimal 50. cursordi query stringopsional next dari jawaban sebelumnya. Tanpa itu, dari awal.
Contoh permintaan curl \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/posts?limit=20"Jawaban Menjawab dengan satu halaman Post
Contoh {
"items": [
{
"id": "5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1",
"text": "The bees are back in the garden 🐝 #garden",
"kind": "poll",
"author": {
"id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
"handle": "mara",
"name": "Mara 🌻",
"verified": true,
"accountKind": "person"
},
"community": {
"id": "c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60",
"name": "Urban Gardening"
},
"media": [
{
"url": "/api/media?id=b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918",
"kind": "image",
"poster": null,
"ai": "without"
}
],
"poll": {
"options": [
{
"text": "Lavender",
"votes": 12
},
{
"text": "Sunflowers",
"votes": 7
},
{
"text": "Clover",
"votes": 3
}
],
"total": 22,
"multiple": false,
"endsAt": null,
"running": true,
"resultsVisible": true,
"myVotes": [
0
]
},
"quotes": null,
"continues": null,
"counts": {
"replies": 4,
"likes": 31,
"reposts": 2
},
"pinned": false,
"giftDrop": {
"item": "plan",
"quantity": 3,
"places": 10,
"left": 4,
"audience": "followers",
"newAccounts": false,
"status": "open",
"claimed": true
},
"createdAt": 1758624000000
}
],
"next": "MTc1ODYyNDAwMDAwMDo1ZjBjMmE5ZS04ZDQx"
}Status yang mungkin: 200304401429
GET /v2/posts/{id}Satu postingan, menurut id-nya.
Hak read dengan ETag sejak v2.0 Di path publik, counts.likes dan counts.reposts selalu 0 dan pinned bernilai false.
Postingan di grup tidak ada di sini, melainkan di /communities/{id}/posts.
Parameter Nama Tipe Arti iddi path stringwajib id sebuah postingan.
Contoh permintaan curl \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/posts/5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1"Jawaban Menjawab dengan satu Post
Contoh {
"id": "5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1",
"text": "The bees are back in the garden 🐝 #garden",
"kind": "poll",
"author": {
"id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
"handle": "mara",
"name": "Mara 🌻",
"verified": true,
"accountKind": "person"
},
"community": {
"id": "c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60",
"name": "Urban Gardening"
},
"media": [
{
"url": "/api/media?id=b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918",
"kind": "image",
"poster": null,
"ai": "without"
}
],
"poll": {
"options": [
{
"text": "Lavender",
"votes": 12
},
{
"text": "Sunflowers",
"votes": 7
},
{
"text": "Clover",
"votes": 3
}
],
"total": 22,
"multiple": false,
"endsAt": null,
"running": true,
"resultsVisible": true,
"myVotes": [
0
]
},
"quotes": null,
"continues": null,
"counts": {
"replies": 4,
"likes": 31,
"reposts": 2
},
"pinned": false,
"giftDrop": {
"item": "plan",
"quantity": 3,
"places": 10,
"left": 4,
"audience": "followers",
"newAccounts": false,
"status": "open",
"claimed": true
},
"createdAt": 1758624000000
}Status yang mungkin: 200304400401404429
POST /v2/postsTerbitkan postingan.
Postingan perlu teks atau jajak pendapat. Panjang, pilihan jajak pendapat, dan laju diatur instans; di luar itu kamu mendapat 400 atau 429.
Lampirkan gambar, GIF, atau video dengan media. GIF atau video berdiri sendiri. Kamu boleh memakai GIF dan video yang dibagikan orang lain di tellmelo.
Postingan untuk teman dekat atau dengan rekan penulis langsung terbit, tidak di grup dan tidak terjadwal. Keduanya tidak bisa sekaligus.
Parameter Nama Tipe Arti textdi isi stringopsional Teks postingan, balasan, atau pesan. communitydi isi stringopsional id grup yang kanal feed-nya menerima postingan; kanal itu harus menyala dan kamu perlu haknya. Tanpa itu, postingan berada di luar grup mana pun.quotesdi isi stringopsional id postingan yang dikutip postingan ini.polldi isi string[]opsional Pilihan jawaban sebagai daftar teks. mediadi isi string[]opsional ID gambar yang diunggah di aplikasi, atau GIF atau video dari perpustakaan media (sejak 2.14). audiencedi isi stringopsional Siapa yang melihat postingan: everyone semua yang boleh, close hanya teman dekatmu.everyoneclose coauthordi isi stringopsional id akun yang kamu undang sebagai rekan penulis. Kalian harus saling mengikuti.
Contoh permintaan curl -X POST \
-H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/json" \
-d '{"text":"The bees are back in the garden 🐝 #garden","audience":"everyone"}' \
"https://api.tellmelo.com/v2/posts"Jawaban Menjawab dengan satu Created
Contoh {
"id": "5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1",
"scheduledFor": null,
"deleteAt": null
}Status yang mungkin: 200400401403429
DELETE /v2/posts/{id}Hapus salah satu postinganmu sendiri.
Parameter Nama Tipe Arti iddi path stringwajib id sebuah postingan.
Contoh permintaan curl -X DELETE \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/posts/5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1"Jawaban Menjawab dengan satu Ok
Contoh {
"ok": true
}Status yang mungkin: 200400401403404429
GET /v2/me/scheduledPostinganmu yang belum tayang, dan apa yang sedang ditunggunya.
Hak read dengan ETag sejak v2.12 Contoh permintaan curl \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/me/scheduled"Jawaban Menjawab dengan satu halaman ScheduledPost
Contoh {
"items": [
{
"id": "5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1",
"text": "Market day tomorrow – see you at the bee stand! #garden",
"communityId": null,
"publishAt": 1758710400000,
"deleteAt": null,
"waitingFor": "time",
"createdAt": 1758624000000
}
],
"next": null
}Status yang mungkin: 200304401429
POST /v2/posts/{id}/scheduleMengubah kapan postingan terjadwal tayang, atau kapan postingan terhapus sendiri.
Hanya postinganmu sendiri. Selama hadiah sebuah postingan belum dibayar, postingan itu tidak bisa dijadwalkan.
Parameter Nama Tipe Arti iddi path stringwajib id sebuah postingan.publishAtdi isi integeropsional Kapan postingan terjadwal tayang, dalam milidetik sejak 1970. deleteAtdi isi integeropsional Kapan postingan terhapus sendiri, dalam milidetik sejak 1970.
Contoh permintaan curl -X POST \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/posts/5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1/schedule"Jawaban Menjawab dengan satu Ok
Contoh {
"ok": true
}Status yang mungkin: 200400401403404429
POST /v2/posts/{id}/editMengubah teks salah satu postinganmu.
Hanya dalam waktu edit yang diberikan paketmu. Postingan terjadwal tidak bisa diedit.
Parameter Nama Tipe Arti iddi path stringwajib id sebuah postingan.textdi isi stringwajib Teks postingan, balasan, atau pesan.
Contoh permintaan curl -X POST \
-H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/json" \
-d '{"text":"The bees are back in the garden 🐝🌻 #garden"}' \
"https://api.tellmelo.com/v2/posts/5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1/edit"Jawaban Menjawab dengan satu Ok
Contoh {
"ok": true
}Status yang mungkin: 200400401403404429
GET /v2/posts/{id}/reply-settingsSiapa yang boleh membalas postinganmu, apakah balasan menunggu persetujuan, dan mode lambat.
Hak read dengan ETag sejak v2.19 Parameter Nama Tipe Arti iddi path stringwajib id sebuah postingan.
Contoh permintaan curl \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/posts/5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1/reply-settings"Jawaban Menjawab dengan satu ReplySettings
Contoh {
"audience": "following",
"approval": false,
"slow": "auto"
}Status yang mungkin: 200304400401404429
PUT /v2/posts/{id}/reply-settingsMengubah pengaturan balasan postinganmu. Yang tidak kamu isi tetap sama.
Hanya postinganmu sendiri.
Parameter Nama Tipe Arti iddi path stringwajib id sebuah postingan.audiencedi isi stringopsional Siapa yang boleh membalas: semua, akun yang kamu ikuti, yang disebut, atau tidak ada.allfollowingmentionednobody approvaldi isi booleanopsional Apakah balasan baru muncul setelah kamu setujui. slowdi isi stringopsional Mode lambat: auto menyala sendiri saat banyak balasan masuk, on selalu, off tidak pernah.autoonoff
Contoh permintaan curl -X PUT \
-H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/json" \
-d '{"audience":"following","approval":false,"slow":"auto"}' \
"https://api.tellmelo.com/v2/posts/5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1/reply-settings"Jawaban Menjawab dengan satu ReplySettings
Contoh {
"audience": "following",
"approval": false,
"slow": "auto"
}Status yang mungkin: 200400401403404429
POST /v2/posts/{id}/coauthorMenerima atau menolak undangan sebagai rekan penulis.
Parameter Nama Tipe Arti iddi path stringwajib id sebuah postingan.acceptdi isi booleanwajib true menerima undangan, false menolaknya.
Contoh permintaan curl -X POST \
-H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/json" \
-d '{"accept":true}' \
"https://api.tellmelo.com/v2/posts/5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1/coauthor"Jawaban Menjawab dengan satu Ok
Contoh {
"ok": true
}Status yang mungkin: 200400401403404429
DELETE /v2/posts/{id}/coauthorMundur sebagai rekan penulis, atau sebagai penulis mengeluarkan rekan penulis dari postingan.
Untuk rekan penulis dan penulis postingan.
Parameter Nama Tipe Arti iddi path stringwajib id sebuah postingan.
Contoh permintaan curl -X DELETE \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/posts/5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1/coauthor"Jawaban Menjawab dengan satu Ok
Contoh {
"ok": true
}Status yang mungkin: 200400401403404429
POST /v2/posts/{id}/pinMenyematkan postinganmu di atas profil, atau melepasnya.
Hanya postinganmu yang terlihat. Berapa banyak yang bisa disematkan tergantung paketmu.
Parameter Nama Tipe Arti iddi path stringwajib id sebuah postingan.activedi isi booleanwajib true menyematkan postingan, false melepasnya.
Contoh permintaan curl -X POST \
-H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/json" \
-d '{"active":true}' \
"https://api.tellmelo.com/v2/posts/5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1/pin"Jawaban Menjawab dengan satu Ok
Contoh {
"ok": true
}Status yang mungkin: 200400401403404429
Balasan Balasan di bawah postingan, sebagai daftar dengan parentId.
GET /v2/posts/{id}/repliesBalasan untuk sebuah postingan, tanpa akun yang diblokir.
Hak read berhalaman dengan ETag sejak v2.0 Daftarnya datar dan sesuai urutan penulisan; parentId menjadikannya pohon. Satu halaman selalu memuat utas utuh. Balasan dari akun yang diblokir dikecualikan.
Parameter Nama Tipe Arti iddi path stringwajib id sebuah postingan.limitdi query integeropsional Entri per halaman: 20 secara bawaan, maksimal 50. cursordi query stringopsional next dari jawaban sebelumnya. Tanpa itu, dari awal.
Contoh permintaan curl \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/posts/5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1/replies?limit=20"Jawaban Menjawab dengan satu halaman Reply
Contoh {
"items": [
{
"id": "9e4b1c7d-2a3f-4d5e-8b6c-0f1e2d3c4b5a",
"text": "Same here, the lavender is full of them.",
"kind": "post",
"author": {
"id": "d4c3b2a1-6e5f-4a7b-9c8d-1e2f3a4b5c6d",
"handle": "jon",
"name": "Jon",
"verified": false,
"accountKind": "person"
},
"community": null,
"media": [],
"poll": null,
"quotes": null,
"continues": null,
"counts": {
"replies": 0,
"likes": 3,
"reposts": 0
},
"pinned": false,
"giftDrop": null,
"createdAt": 1758624600000,
"postId": "5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1",
"parentId": null
}
],
"next": "MTc1ODYyNDAwMDAwMDo1ZjBjMmE5ZS04ZDQx"
}Status yang mungkin: 200304400401404429
POST /v2/posts/{id}/repliesBalas sebuah postingan.
Dalam mode lambat, satu balasan per orang setiap 10 menit, selain itu 429. Penulis dan akun yang diikutinya dikecualikan.
Dengan media maksimal satu gambar, GIF, atau video.
Parameter Nama Tipe Arti iddi path stringwajib id sebuah postingan.textdi isi stringwajib Teks postingan, balasan, atau pesan. parentIddi isi stringopsional id balasan yang dijawab balasan ini. Tanpa itu, langsung ke postingan.mediadi isi string[]opsional ID gambar yang diunggah di aplikasi, atau GIF atau video dari perpustakaan media (sejak 2.14). publishAtdi isi integeropsional Kapan balasan terbit, dalam milidetik sejak 1970. Tanpa ini, langsung terkirim.
Contoh permintaan curl -X POST \
-H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/json" \
-d '{"text":"Same here, the lavender is full of them."}' \
"https://api.tellmelo.com/v2/posts/5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1/replies"Jawaban Menjawab dengan satu Created
Contoh {
"id": "5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1",
"scheduledFor": null,
"deleteAt": null
}Status yang mungkin: 200400401403404429
POST /v2/replies/{id}/editMengubah teks salah satu balasanmu.
Parameter Nama Tipe Arti iddi path stringwajib id balasan. textdi isi stringwajib Teks postingan, balasan, atau pesan.
Contoh permintaan curl -X POST \
-H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/json" \
-d '{"text":"Same here, the lavender and the clover are full of them."}' \
"https://api.tellmelo.com/v2/replies/9e4b1c7d-2a3f-4d5e-8b6c-0f1e2d3c4b5a/edit"Jawaban Menjawab dengan satu Ok
Contoh {
"ok": true
}Status yang mungkin: 200400401403404429
DELETE /v2/replies/{id}Menghapus salah satu balasanmu.
Parameter Nama Tipe Arti iddi path stringwajib id balasan.
Contoh permintaan curl -X DELETE \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/replies/9e4b1c7d-2a3f-4d5e-8b6c-0f1e2d3c4b5a"Jawaban Menjawab dengan satu Ok
Contoh {
"ok": true
}Status yang mungkin: 200400401403404429
POST /v2/replies/{id}/likeBeri suara naik untuk balasan (suka adalah suara naik sejak balasan diberi suara) atau tarik kembali; suara turun tetap.
Hak write sejak v2.12 usang Usang sejak 2.19: gunakan POST /replies/{id}/vote. Rute ini tetap ada untuk sementara.
Parameter Nama Tipe Arti iddi path stringwajib id balasan. activedi isi booleanwajib true memasang relasi, false menghapusnya.
Contoh permintaan curl -X POST \
-H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/json" \
-d '{"active":true}' \
"https://api.tellmelo.com/v2/replies/9e4b1c7d-2a3f-4d5e-8b6c-0f1e2d3c4b5a/like"Jawaban Menjawab dengan satu Ok
Contoh {
"ok": true
}Status yang mungkin: 200400401403404429
POST /v2/replies/{id}/voteMemberi suara naik atau turun pada sebuah balasan, atau menarik suaramu. Menjawab dengan suaramu dan skor sesudahnya.
Parameter Nama Tipe Arti iddi path stringwajib id balasan. votedi isi stringwajib up memberi suara naik, down turun, none menarik suaramu.updownnone
Contoh permintaan curl -X POST \
-H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/json" \
-d '{"vote":"up"}' \
"https://api.tellmelo.com/v2/replies/9e4b1c7d-2a3f-4d5e-8b6c-0f1e2d3c4b5a/vote"Jawaban Menjawab dengan satu ReplyVote
Contoh {
"vote": "up",
"score": 12
}Status yang mungkin: 200400401403404429
POST /v2/replies/{id}/pickMenyorot satu balasan di postinganmu sebagai yang terbaik, atau mencabut sorotan.
Hanya di postinganmu sendiri dan hanya balasan langsung ke postingan. Sorotan baru menggantikan yang lama.
Parameter Nama Tipe Arti iddi path stringwajib id balasan. activedi isi booleanwajib true menyorot balasan, false mencabut sorotan.
Contoh permintaan curl -X POST \
-H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/json" \
-d '{"active":true}' \
"https://api.tellmelo.com/v2/replies/9e4b1c7d-2a3f-4d5e-8b6c-0f1e2d3c4b5a/pick"Jawaban Menjawab dengan satu Ok
Contoh {
"ok": true
}Status yang mungkin: 200400401403404429
GET /v2/posts/{id}/replies/waitingBalasan yang menunggu persetujuan di sebuah postingan: semuanya di postinganmu, selain itu hanya milikmu.
Hak read dengan ETag sejak v2.19 Apakah balasan menunggu, diatur penulis di pengaturan balasan.
Parameter Nama Tipe Arti iddi path stringwajib id sebuah postingan.
Contoh permintaan curl \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/posts/5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1/replies/waiting"Jawaban Menjawab dengan satu halaman Reply
Contoh {
"items": [
{
"id": "9e4b1c7d-2a3f-4d5e-8b6c-0f1e2d3c4b5a",
"text": "Same here, the lavender is full of them.",
"kind": "post",
"author": {
"id": "d4c3b2a1-6e5f-4a7b-9c8d-1e2f3a4b5c6d",
"handle": "jon",
"name": "Jon",
"verified": false,
"accountKind": "person"
},
"community": null,
"media": [],
"poll": null,
"quotes": null,
"continues": null,
"counts": {
"replies": 0,
"likes": 3,
"reposts": 0
},
"pinned": false,
"giftDrop": null,
"createdAt": 1758624600000,
"postId": "5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1",
"parentId": null
}
],
"next": null
}Status yang mungkin: 200304400401404429
POST /v2/replies/{id}/decideMenyetujui atau menolak balasan yang menunggu di postinganmu. Yang ditolak akan dihapus.
Parameter Nama Tipe Arti iddi path stringwajib id balasan. approvedi isi booleanwajib true menyetujui balasan, false menolaknya.
Contoh permintaan curl -X POST \
-H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/json" \
-d '{"approve":true}' \
"https://api.tellmelo.com/v2/replies/9e4b1c7d-2a3f-4d5e-8b6c-0f1e2d3c4b5a/decide"Jawaban Menjawab dengan satu Ok
Contoh {
"ok": true
}Status yang mungkin: 200400401403404429
GET /v2/posts/{id}/replies/plannedBalasanmu yang dijadwalkan untuk nanti di sebuah postingan.
Hak read dengan ETag sejak v2.19 Jadwalkan dengan publishAt saat membalas. Paling banyak 20 balasan terjadwal sekaligus.
Parameter Nama Tipe Arti iddi path stringwajib id sebuah postingan.
Contoh permintaan curl \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/posts/5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1/replies/planned"Jawaban Menjawab dengan satu halaman PlannedReply
Contoh {
"items": [
{
"id": "3b2a1c0d-9e8f-4a7b-b6c5-d4e3f2a1b0c9",
"parentId": null,
"text": "Count me in for Saturday!",
"publishAt": 1758710400000,
"state": "waiting"
}
],
"next": null
}Status yang mungkin: 200304400401404429
PUT /v2/me/planned-replies/{id}Mengubah teks atau waktu balasan terjadwal. Yang gagal akan menunggu lagi.
Parameter Nama Tipe Arti iddi path stringwajib id balasan terjadwal.textdi isi stringopsional Teks postingan, balasan, atau pesan. publishAtdi isi integeropsional Kapan balasan terbit, dalam milidetik sejak 1970. Tanpa ini, langsung terkirim.
Contoh permintaan curl -X PUT \
-H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/json" \
-d '{"text":"See you there!","publishAt":1758700000000}' \
"https://api.tellmelo.com/v2/me/planned-replies/3b2a1c0d-9e8f-4a7b-b6c5-d4e3f2a1b0c9"Jawaban Menjawab dengan satu Ok
Contoh {
"ok": true
}Status yang mungkin: 200400401403404429
POST /v2/me/planned-replies/{id}/sendMengirim balasan terjadwal sekarang juga.
Parameter Nama Tipe Arti iddi path stringwajib id balasan terjadwal.
Contoh permintaan curl -X POST \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/me/planned-replies/3b2a1c0d-9e8f-4a7b-b6c5-d4e3f2a1b0c9/send"Jawaban Menjawab dengan satu Ok
Contoh {
"ok": true
}Status yang mungkin: 200400401403404429
DELETE /v2/me/planned-replies/{id}Menghapus balasan terjadwal.
Parameter Nama Tipe Arti iddi path stringwajib id balasan terjadwal.
Contoh permintaan curl -X DELETE \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/me/planned-replies/3b2a1c0d-9e8f-4a7b-b6c5-d4e3f2a1b0c9"Jawaban Menjawab dengan satu Ok
Contoh {
"ok": true
}Status yang mungkin: 200400401403404429
Jajak pendapat Jajak pendapat adalah postingan yang poll-nya diisi. Memilih punya path sendiri.
POST /v2/posts/{id}/voteIkut dalam jajak pendapat.
Suara per pilihan bernilai null sampai kamu memilih atau jajak pendapat berakhir. total selalu ada.
Parameter Nama Tipe Arti iddi path stringwajib id sebuah postingan.optiondi isi integerwajib Pilihan mana, dihitung dari 0. Untuk pilihan ganda, panggil sekali per pilihan. retractdi isi booleanopsional true menarik suara.
Contoh permintaan curl -X POST \
-H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/json" \
-d '{"option":0}' \
"https://api.tellmelo.com/v2/posts/5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1/vote"Jawaban Menjawab dengan satu Ok
Contoh {
"ok": true
}Status yang mungkin: 200400401403404429
Profil Profil publik menurut nama pendeknya, dan apa yang mereka posting.
GET /v2/profiles/{handle}Sebuah profil, menurut nama pendeknya.
Hak read dengan ETag sejak v2.0 Parameter Nama Tipe Arti handledi path stringwajib Nama pendek sebuah profil, huruf besar atau kecil sama saja.
Contoh permintaan curl \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/profiles/mara"Jawaban Menjawab dengan satu Profile
Contoh {
"id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
"handle": "mara",
"name": "Mara 🌻",
"verified": true,
"accountKind": "person",
"about": "Beekeeper, allotment, too many seeds. :tellmelo:",
"website": "https://mara-imkerei.example/",
"websiteVerified": true,
"followers": 148,
"createdAt": 1750848000000
}Status yang mungkin: 200304400401404429
GET /v2/profiles/{handle}/postsPostingan publik dari satu profil, yang terbaru lebih dulu.
Hak read berhalaman dengan ETag sejak v2.0 Di path publik, counts.likes dan counts.reposts selalu 0 dan pinned bernilai false.
Postingan di grup tidak ada di sini, melainkan di /communities/{id}/posts.
Parameter Nama Tipe Arti handledi path stringwajib Nama pendek sebuah profil, huruf besar atau kecil sama saja. limitdi query integeropsional Entri per halaman: 20 secara bawaan, maksimal 50. cursordi query stringopsional next dari jawaban sebelumnya. Tanpa itu, dari awal.
Contoh permintaan curl \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/profiles/mara/posts?limit=20"Jawaban Menjawab dengan satu halaman Post
Contoh {
"items": [
{
"id": "5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1",
"text": "The bees are back in the garden 🐝 #garden",
"kind": "poll",
"author": {
"id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
"handle": "mara",
"name": "Mara 🌻",
"verified": true,
"accountKind": "person"
},
"community": {
"id": "c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60",
"name": "Urban Gardening"
},
"media": [
{
"url": "/api/media?id=b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918",
"kind": "image",
"poster": null,
"ai": "without"
}
],
"poll": {
"options": [
{
"text": "Lavender",
"votes": 12
},
{
"text": "Sunflowers",
"votes": 7
},
{
"text": "Clover",
"votes": 3
}
],
"total": 22,
"multiple": false,
"endsAt": null,
"running": true,
"resultsVisible": true,
"myVotes": [
0
]
},
"quotes": null,
"continues": null,
"counts": {
"replies": 4,
"likes": 31,
"reposts": 2
},
"pinned": false,
"giftDrop": {
"item": "plan",
"quantity": 3,
"places": 10,
"left": 4,
"audience": "followers",
"newAccounts": false,
"status": "open",
"claimed": true
},
"createdAt": 1758624000000
}
],
"next": "MTc1ODYyNDAwMDAwMDo1ZjBjMmE5ZS04ZDQx"
}Status yang mungkin: 200304400401404429
GET /v2/profiles/{handle}/eventsAcara mendatang dari sebuah profil, yang terdekat dulu.
Hak read dengan ETag sejak v2.19 Hanya selama paket profil mencakup acara. Tidak ada apa pun antara akun yang saling memblokir.
Parameter Nama Tipe Arti handledi path stringwajib Nama pendek sebuah profil, huruf besar atau kecil sama saja.
Contoh permintaan curl \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/profiles/mara/events"Jawaban Menjawab dengan satu halaman Event
Contoh {
"items": [
{
"id": "2a3b4c5d-6e7f-4809-9a1b-2c3d4e5f6a7b",
"title": "Seed swap",
"startsAt": 1758883200000,
"endsAt": 1758890400000,
"place": "Community garden",
"description": "Bring seeds, take seeds.",
"signups": {
"count": 14,
"going": true
}
}
],
"next": null
}Status yang mungkin: 200304400401404429
POST /v2/me/eventsMembuat acara. Menjawab dengan id-nya.
Butuh paket dengan acara, kalau tidak 403. Berapa yang bisa dijadwalkan tergantung paket.
Parameter Nama Tipe Arti titledi isi stringwajib Judulnya. startsAtdi isi integerwajib Mulai, dalam milidetik sejak 1970. endsAtdi isi integeropsional Selesai, dalam milidetik sejak 1970. Opsional. placedi isi stringopsional Di mana acara berlangsung. descriptiondi isi stringopsional Deskripsi. signupsdi isi booleanopsional Apakah orang bisa mendaftar. Butuh paket dengan pendaftaran. capacitydi isi integeropsional Berapa orang paling banyak bisa mendaftar. Tanpa ini, tanpa batas.
Contoh permintaan curl -X POST \
-H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/json" \
-d '{"title":"Seed swap","startsAt":1758700000000,"place":"Community garden","signups":true,"capacity":30}' \
"https://api.tellmelo.com/v2/me/events"Jawaban Menjawab dengan satu Made
Contoh {
"id": "0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a"
}Status yang mungkin: 200400401403429
PUT /v2/me/events/{id}Mengubah salah satu acaramu. Semua kolom diatur ulang.
Acara yang sudah mulai tetap memakai waktu mulainya.
Parameter Nama Tipe Arti iddi path stringwajib id acara.titledi isi stringwajib Judulnya. startsAtdi isi integerwajib Mulai, dalam milidetik sejak 1970. endsAtdi isi integeropsional Selesai, dalam milidetik sejak 1970. Opsional. placedi isi stringopsional Di mana acara berlangsung. descriptiondi isi stringopsional Deskripsi. signupsdi isi booleanopsional Apakah orang bisa mendaftar. Butuh paket dengan pendaftaran. capacitydi isi integeropsional Berapa orang paling banyak bisa mendaftar. Tanpa ini, tanpa batas.
Contoh permintaan curl -X PUT \
-H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/json" \
-d '{"title":"Seed swap","startsAt":1758700000000,"place":"Community garden","signups":true,"capacity":30}' \
"https://api.tellmelo.com/v2/me/events/2a3b4c5d-6e7f-4809-9a1b-2c3d4e5f6a7b"Jawaban Menjawab dengan satu Made
Contoh {
"id": "0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a"
}Status yang mungkin: 200400401403404429
DELETE /v2/me/events/{id}Menghapus salah satu acaramu.
Parameter Nama Tipe Arti iddi path stringwajib id acara.
Contoh permintaan curl -X DELETE \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/me/events/2a3b4c5d-6e7f-4809-9a1b-2c3d4e5f6a7b"Jawaban Menjawab dengan satu Ok
Contoh {
"ok": true
}Status yang mungkin: 200400401403404429
GET /v2/me/events/{id}/signupsSiapa yang mendaftar ke salah satu acaramu.
Hak read dengan ETag sejak v2.19 Parameter Nama Tipe Arti iddi path stringwajib id acara.
Contoh permintaan curl \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/me/events/2a3b4c5d-6e7f-4809-9a1b-2c3d4e5f6a7b/signups"Jawaban Menjawab dengan satu halaman EventSignup
Contoh {
"items": [
{
"id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
"handle": "mara",
"name": "Mara 🌻",
"at": 1758624000000
}
],
"next": null
}Status yang mungkin: 200304400401404429
POST /v2/events/{id}/signupMendaftar ke acara atau membatalkannya.
Hanya untuk acara dengan pendaftaran, bukan acaramu sendiri. Jika penuh, 409.
Parameter Nama Tipe Arti iddi path stringwajib id acara.goingdi isi booleanwajib true mendaftarkanmu, false membatalkan.
Contoh permintaan curl -X POST \
-H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/json" \
-d '{"going":true}' \
"https://api.tellmelo.com/v2/events/2a3b4c5d-6e7f-4809-9a1b-2c3d4e5f6a7b/signup"Jawaban Menjawab dengan satu Ok
Contoh {
"ok": true
}Status yang mungkin: 200400401403404429
Grup Grup terbuka dan grupmu sendiri, beserta postingan, anggota, peran, dan tautan undangannya.
GET /v2/communitiesGrup terbuka di instance ini; dengan mine=true, grup milik akunmu.
Hak read dengan ETag sejak v2.0 Diurutkan menurut jumlah anggota dan tidak berhalaman; next selalu null.
Parameter Nama Tipe Arti limitdi query integeropsional Entri per halaman: 20 secara bawaan, maksimal 50. minedi query booleanopsional true untuk grup milik akunmu, termasuk yang internal dan tersembunyi, menurut nama.
Contoh permintaan curl \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/communities?limit=20"Jawaban Menjawab dengan satu halaman Community
Contoh {
"items": [
{
"id": "c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60",
"name": "Urban Gardening",
"handle": "urbangardening",
"description": "Balconies, allotments, rooftops: whatever grows.",
"tags": [
"garden",
"bees"
],
"members": 312,
"joinPolicy": "open",
"visibility": "open",
"feedChannel": true,
"sparks": 24,
"perks": [
"tint",
"welcome"
],
"membership": {
"leader": null,
"roles": [
"4e5f6a7b-8c9d-4e0f-a1b2-c3d4e5f6a7b8"
],
"permissions": [
"attach",
"invite",
"send",
"view"
],
"mutedUntil": null
}
}
],
"next": null
}Status yang mungkin: 200304401429
GET /v2/communities/{id}Satu grup, menurut id-nya.
Hak read dengan ETag sejak v2.0 Grup internal dan tersembunyi hanya jika akunmu anggotanya.
Parameter Nama Tipe Arti iddi path stringwajib id sebuah grup.
Contoh permintaan curl \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60"Jawaban Menjawab dengan satu Community
Contoh {
"id": "c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60",
"name": "Urban Gardening",
"handle": "urbangardening",
"description": "Balconies, allotments, rooftops: whatever grows.",
"tags": [
"garden",
"bees"
],
"members": 312,
"joinPolicy": "open",
"visibility": "open",
"feedChannel": true,
"sparks": 24,
"perks": [
"tint",
"welcome"
],
"membership": {
"leader": null,
"roles": [
"4e5f6a7b-8c9d-4e0f-a1b2-c3d4e5f6a7b8"
],
"permissions": [
"attach",
"invite",
"send",
"view"
],
"mutedUntil": null
}
}Status yang mungkin: 200304400401404429
GET /v2/communities/{id}/postsPostingan kanal feed sebuah grup, terbaru dulu.
Hak read berhalaman dengan ETag sejak v2.0 Di path publik, counts.likes dan counts.reposts selalu 0 dan pinned bernilai false.
Jika kanal feed mati, jalur menjawab 409 dengan feed_off.
Parameter Nama Tipe Arti iddi path stringwajib id sebuah grup.limitdi query integeropsional Entri per halaman: 20 secara bawaan, maksimal 50. cursordi query stringopsional next dari jawaban sebelumnya. Tanpa itu, dari awal.
Contoh permintaan curl \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/posts?limit=20"Jawaban Menjawab dengan satu halaman Post
Contoh {
"items": [
{
"id": "5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1",
"text": "The bees are back in the garden 🐝 #garden",
"kind": "poll",
"author": {
"id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
"handle": "mara",
"name": "Mara 🌻",
"verified": true,
"accountKind": "person"
},
"community": {
"id": "c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60",
"name": "Urban Gardening"
},
"media": [
{
"url": "/api/media?id=b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918",
"kind": "image",
"poster": null,
"ai": "without"
}
],
"poll": {
"options": [
{
"text": "Lavender",
"votes": 12
},
{
"text": "Sunflowers",
"votes": 7
},
{
"text": "Clover",
"votes": 3
}
],
"total": 22,
"multiple": false,
"endsAt": null,
"running": true,
"resultsVisible": true,
"myVotes": [
0
]
},
"quotes": null,
"continues": null,
"counts": {
"replies": 4,
"likes": 31,
"reposts": 2
},
"pinned": false,
"giftDrop": {
"item": "plan",
"quantity": 3,
"places": 10,
"left": 4,
"audience": "followers",
"newAccounts": false,
"status": "open",
"claimed": true
},
"createdAt": 1758624000000
}
],
"next": "MTc1ODYyNDAwMDAwMDo1ZjBjMmE5ZS04ZDQx"
}Status yang mungkin: 200304400401404429
GET /v2/communities/{id}/membersAnggota sebuah grup beserta perannya.
Hak read dengan ETag sejak v2.15 Pengurus dulu, lalu menurut peran tertinggi; paling banyak 300.
Parameter Nama Tipe Arti iddi path stringwajib id sebuah grup.
Contoh permintaan curl \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/members"Jawaban Menjawab dengan satu halaman GroupMember
Contoh {
"items": [
{
"id": "d4c3b2a1-6e5f-4a7b-9c8d-1e2f3a4b5c6d",
"handle": "jon",
"name": "Jon",
"bot": false,
"leader": null,
"roles": [
"4e5f6a7b-8c9d-4e0f-a1b2-c3d4e5f6a7b8"
],
"mutedUntil": null
}
],
"next": null
}Status yang mungkin: 200304400401404429
GET /v2/communities/{id}/rolesPeran sebuah grup, yang tertinggi dulu, @everyone terakhir.
Hak read dengan ETag sejak v2.15 Parameter Nama Tipe Arti iddi path stringwajib id sebuah grup.
Contoh permintaan curl \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/roles"Jawaban Menjawab dengan satu halaman Role
Contoh {
"items": [
{
"id": "4e5f6a7b-8c9d-4e0f-a1b2-c3d4e5f6a7b8",
"name": "Gardeners",
"everyone": false,
"color": "green",
"permissions": [
"attach",
"invite",
"send",
"view"
],
"members": 24,
"editable": true,
"selfable": false
}
],
"next": null
}Status yang mungkin: 200304400401404429
GET /v2/communities/{id}/bellNotifikasi apa yang dikirim sebuah grup kepadamu.
Hak read dengan ETag sejak v2.15 Parameter Nama Tipe Arti iddi path stringwajib id sebuah grup.
Contoh permintaan curl \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/bell"Jawaban Menjawab dengan satu Bell
Contoh {
"level": "important"
}Status yang mungkin: 200304400401404429
GET /v2/invites/{code}Grup di balik tautan undangan, sebelum bergabung.
Hak read dengan ETag sejak v2.15 Parameter Nama Tipe Arti codedi path stringwajib Kode tautan undangan, bagian akhir alamatnya.
Contoh permintaan curl \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/invites/k7Qm2xPa"Jawaban Menjawab dengan satu InvitePreview
Contoh {
"community": {
"id": "c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60",
"name": "Urban Gardening",
"members": 312,
"rules": [
"Be kind.",
"No advertising."
]
},
"member": false
}Status yang mungkin: 200304400401404429
PUT /v2/roles/{id}/selfMengambil atau melepas peran pilihan sendiri.
Hanya peran yang ditawarkan pengelola sebagai pilihan sendiri (selfable), dan hanya untuk akunmu sendiri.
Parameter Nama Tipe Arti iddi path stringwajib id sebuah peran.activedi isi booleanopsional false mencabut peran; selain itu peran diberikan.
Contoh permintaan curl -X PUT \
-H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/json" \
-d '{"active":true}' \
"https://api.tellmelo.com/v2/roles/4e5f6a7b-8c9d-4e0f-a1b2-c3d4e5f6a7b8/self"Jawaban Menjawab dengan satu Ok
Contoh {
"ok": true
}Status yang mungkin: 200400401403404429
GET /v2/communities/{id}/emojisEmoji milik sebuah grup.
Hak read dengan ETag sejak v2.20 Parameter Nama Tipe Arti iddi path stringwajib id sebuah grup.
Contoh permintaan curl \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/emojis"Jawaban Menjawab dengan satu halaman GroupEmoji
Contoh {
"items": [
{
"name": "seedling",
"url": "/api/media?id=8c7b6a59-4837-4261-9f5e-d4c3b2a1f0e9",
"animated": false
}
],
"next": null
}Status yang mungkin: 200304400401404429
PUT /v2/communities/{id}/bellMengatur notifikasi apa yang dikirim sebuah grup kepadamu.
Parameter Nama Tipe Arti iddi path stringwajib id sebuah grup.leveldi isi stringwajib Notifikasi apa yang datang.allimportantoff
Contoh permintaan curl -X PUT \
-H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/json" \
-d '{"level":"important"}' \
"https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/bell"Jawaban Menjawab dengan satu Bell
Contoh {
"level": "important"
}Status yang mungkin: 200400401403404429
POST /v2/invites/{code}/joinBergabung ke grup dengan tautan undangan.
Parameter Nama Tipe Arti codedi path stringwajib Kode tautan undangan, bagian akhir alamatnya. rulesdi isi booleanopsional true jika kamu menerima aturan grup; diperlukan jika grup punya aturan.
Contoh permintaan curl -X POST \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/invites/k7Qm2xPa/join"Jawaban Menjawab dengan satu Joined
Contoh {
"community": "c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60"
}Status yang mungkin: 200400401403404429
GET /v2/communities/{id}/botsBot sebuah grup beserta apa yang diizinkan perannya.
Hak read dengan ETag sejak v2.19 Parameter Nama Tipe Arti iddi path stringwajib id sebuah grup.
Contoh permintaan curl \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/bots"Jawaban Menjawab dengan satu halaman GroupBot
Contoh {
"items": [
{
"id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
"handle": "gardenbot",
"name": "Garden bot",
"description": "Reminds the group of watering days.",
"permissions": [
"send",
"view"
]
}
],
"next": null
}Status yang mungkin: 200304400401404429
Kanal Kanal grupmu dan obrolannya: membaca, menulis, menandai sudah dibaca.
GET /v2/communities/{id}/channelsKanal sebuah grup yang kamu lihat, sesuai urutannya.
Hak read dengan ETag sejak v2.15 Kanal feed (kind: feed) hanya ada di sini selama menyala; postingannya datang lewat /communities/{id}/posts.
Parameter Nama Tipe Arti iddi path stringwajib id sebuah grup.
Contoh permintaan curl \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/channels"Jawaban Menjawab dengan satu halaman Channel
Contoh {
"items": [
{
"id": "0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a",
"kind": "chat",
"name": "harvest",
"topic": "What came in this week",
"category": {
"id": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",
"name": "Garden",
"symbol": {
"emoji": null,
"icon": null,
"image": null,
"color": null,
"shape": null
}
},
"unread": 3,
"permissions": [
"view",
"send"
],
"symbol": {
"emoji": "🌻",
"icon": null,
"image": null,
"color": "amber",
"shape": "circle"
}
}
],
"next": null
}Status yang mungkin: 200304400401404429
GET /v2/channels/{id}/messagesPesan di kanal obrolan, terbaru dulu.
Hak read berhalaman dengan ETag sejak v2.15 Hingga 50 pesan per halaman. Pesan dari akun yang kamu blokir atau yang memblokirmu tidak ada.
Parameter Nama Tipe Arti iddi path stringwajib id sebuah kanal.cursordi query stringopsional next dari jawaban sebelumnya. Tanpa itu, dari awal.threaddi query stringopsional Pesan yang utasnya dibaca: pesan itu dan balasannya, bukan obrolan.
Contoh permintaan curl \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/channels/0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a/messages"Jawaban Menjawab dengan satu halaman ChannelMessage
Contoh {
"items": [
{
"id": "61a2b3c4-d5e6-4f70-8192-a3b4c5d6e7f8",
"text": "@jon the first tomatoes are ripe 🍅",
"author": {
"id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
"handle": "mara",
"name": "Mara 🌻",
"bot": false
},
"media": [
{
"url": "/api/media?id=b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918",
"kind": "image",
"poster": null,
"ai": "without"
}
],
"replyTo": "72b3c4d5-e6f7-4081-92a3-b4c5d6e7f809",
"roleColor": "green",
"threadOf": null,
"threadCount": 3,
"card": null,
"buttons": [],
"createdAt": 1758631200000
}
],
"next": "MTc1ODYyNDAwMDAwMDo1ZjBjMmE5ZS04ZDQx"
}Status yang mungkin: 200304400401404429
POST /v2/channels/{id}/messagesMenulis pesan di kanal obrolan.
@nama memberi tahu seorang anggota, @everyone dengan haknya memberi tahu semua, paling banyak enam kali per jam.
Parameter Nama Tipe Arti iddi path stringwajib id sebuah kanal.textdi isi stringopsional Teks postingan, balasan, atau pesan. replyTodi isi stringopsional id pesan di kanal yang sama yang kamu balas.mediadi isi string[]opsional ID gambar yang diunggah di aplikasi, atau GIF atau video dari perpustakaan media (sejak 2.14). threaddi isi stringopsional Pesan obrolan yang utasnya dibalas; tanpa itu pesan masuk ke obrolan. carddi isi objectopsional Kartu { title, text, color, fields: [{ name, value }] }, paling banyak 10 bidang. buttonsdi isi object[]opsional Hingga 5 tombol, masing-masing { id, label, style } dengan style primary, secondary, atau danger. Tekanan datang sebagai peristiwa interaction.
Contoh permintaan curl -X POST \
-H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/json" \
-d '{"text":"Who has seeds to swap?"}' \
"https://api.tellmelo.com/v2/channels/0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a/messages"Jawaban Menjawab dengan satu Made
Contoh {
"id": "0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a"
}Status yang mungkin: 200400401403404429
POST /v2/channels/{id}/readMenandai kanal obrolan sudah dibaca hingga suatu waktu.
Parameter Nama Tipe Arti iddi path stringwajib id sebuah kanal.atdi isi integerwajib Sampai kapan sudah dibaca, dalam milidetik, biasanya createdAt pesan terbaru.
Contoh permintaan curl -X POST \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/channels/0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a/read"Jawaban Menjawab dengan satu Ok
Contoh {
"ok": true
}Status yang mungkin: 200400401403404429
DELETE /v2/channel-messages/{id}Menghapus pesanmu sendiri di kanal obrolan.
Hanya pesanmu sendiri; pesan orang lain dihapus pengurus dengan izin groups .
Parameter Nama Tipe Arti iddi path stringwajib id sebuah pesan di kanal obrolan.
Contoh permintaan curl -X DELETE \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/channel-messages/61a2b3c4-d5e6-4f70-8192-a3b4c5d6e7f8"Jawaban Menjawab dengan satu Ok
Contoh {
"ok": true
}Status yang mungkin: 200400401403404429
GET /v2/communities/{id}/voiceSiapa yang sedang ada di saluran suara sebuah grup, per saluran.
Hak read dengan ETag sejak v2.19 Hanya saluran yang boleh kamu lihat. Tanpa server media, daftarnya kosong.
Parameter Nama Tipe Arti iddi path stringwajib id sebuah grup.
Contoh permintaan curl \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/voice"Jawaban Menjawab dengan satu halaman VoiceRoom
Contoh {
"items": [
{
"channel": "0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a",
"people": [
{
"id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
"handle": "mara",
"name": "Mara 🌻",
"muted": false,
"deaf": false,
"camera": false,
"screen": true
}
]
}
],
"next": null
}Status yang mungkin: 200304400401404429
Mengelola grup Apa yang bisa dilakukan pengaturan grup di aplikasi, dengan izin groups . Apa yang boleh dilakukan akunmu ditentukan grup seperti di aplikasi: pengurus, peran, dan urutannya.
POST /v2/communities/{id}/emojisMenambahkan emoji ke grup.
Hanya yang boleh mengelola kanal grup. Gambar diunggah seperti emoji milikmu (POST /me/emojis/pictures); sebuah nama hanya dipakai sekali di antara semua emoji.
Parameter Nama Tipe Arti iddi path stringwajib id sebuah grup.namedi isi stringwajib Nama yang kamu pakai untuk menulis emoji, seperti :nama:. picturedi isi stringwajib id dari POST /me/emojis/pictures.
Contoh permintaan curl -X POST \
-H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/json" \
-d '{"name":"seedling","picture":"8c7b6a59-4837-4261-9f5e-d4c3b2a1f0e9"}' \
"https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/emojis"Jawaban Menjawab dengan satu halaman GroupEmoji
Contoh {
"items": [
{
"name": "seedling",
"url": "/api/media?id=8c7b6a59-4837-4261-9f5e-d4c3b2a1f0e9",
"animated": false
}
],
"next": null
}Status yang mungkin: 200400401403404429
DELETE /v2/communities/{id}/emojis/{name}Menghapus emoji dari grup.
Parameter Nama Tipe Arti iddi path stringwajib id sebuah grup.namedi path stringwajib Nama emoji, tanpa titik dua.
Contoh permintaan curl -X DELETE \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/emojis/seedling"Jawaban Menjawab dengan satu halaman GroupEmoji
Contoh {
"items": [
{
"name": "seedling",
"url": "/api/media?id=8c7b6a59-4837-4261-9f5e-d4c3b2a1f0e9",
"animated": false
}
],
"next": null
}Status yang mungkin: 200400401403404429
POST /v2/communities/{id}/rolesMembuat peran.
Hanya peran di bawah peran tertinggimu dan hanya hak yang kamu punya sendiri; pengurus berada di atas semuanya.
Parameter Nama Tipe Arti iddi path stringwajib id sebuah grup.namedi isi stringopsional Nama peran; @everyone tetap memakai namanya. colordi isi stringopsional Warna; kosong untuk tanpa warna.indigovioletroseambergreenteal permissionsdi isi string[]opsional Hak: view, send, attach, post_feed, invite, mention_everyone, moderate, timeout_members, kick_members, ban_members, manage_channels, manage_roles. selfabledi isi booleanopsional true: anggota mengambil peran sendiri. Hanya untuk peran yang tidak mengizinkan lebih dari ikut serta (view, send, attach, voice_connect, voice_speak, voice_video).
Contoh permintaan curl -X POST \
-H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/json" \
-d '{"name":"Gardeners","permissions":["view","send","invite"],"selfable":false}' \
"https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/roles"Jawaban Menjawab dengan satu Made
Contoh {
"id": "0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a"
}Status yang mungkin: 200400401403404429
PUT /v2/roles/{id}Mengubah nama, warna, dan hak sebuah peran.
Mengganti nama, warna, dan hak; yang kamu lewatkan menjadi kosong.
Hanya peran di bawah peran tertinggimu dan hanya hak yang kamu punya sendiri; pengurus berada di atas semuanya.
Parameter Nama Tipe Arti iddi path stringwajib id sebuah peran.namedi isi stringopsional Nama peran; @everyone tetap memakai namanya. colordi isi stringopsional Warna; kosong untuk tanpa warna.indigovioletroseambergreenteal permissionsdi isi string[]opsional Hak: view, send, attach, post_feed, invite, mention_everyone, moderate, timeout_members, kick_members, ban_members, manage_channels, manage_roles. selfabledi isi booleanopsional true: anggota mengambil peran sendiri. Hanya untuk peran yang tidak mengizinkan lebih dari ikut serta (view, send, attach, voice_connect, voice_speak, voice_video).
Contoh permintaan curl -X PUT \
-H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/json" \
-d '{"name":"Gardeners","permissions":["view","send","invite"],"selfable":false}' \
"https://api.tellmelo.com/v2/roles/4e5f6a7b-8c9d-4e0f-a1b2-c3d4e5f6a7b8"Jawaban Menjawab dengan satu Made
Contoh {
"id": "0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a"
}Status yang mungkin: 200400401403404429
DELETE /v2/roles/{id}Menghapus peran.
Parameter Nama Tipe Arti iddi path stringwajib id sebuah peran.
Contoh permintaan curl -X DELETE \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/roles/4e5f6a7b-8c9d-4e0f-a1b2-c3d4e5f6a7b8"Jawaban Menjawab dengan satu Ok
Contoh {
"ok": true
}Status yang mungkin: 200400401403404429
PUT /v2/communities/{id}/roles/orderMenetapkan urutan peran.
Parameter Nama Tipe Arti iddi path stringwajib id sebuah grup.rolesdi isi string[]wajib id semua peran di bawah peran tertinggimu, yang tertinggi lebih dulu; bagi pimpinan semua kecuali @everyone.
Contoh permintaan curl -X PUT \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/roles/order"Jawaban Menjawab dengan satu Ok
Contoh {
"ok": true
}Status yang mungkin: 200400401403404429
PUT /v2/roles/{id}/members/{member}Memberi atau mencabut peran seorang anggota.
Parameter Nama Tipe Arti iddi path stringwajib id sebuah peran.memberdi path stringwajib id akun seorang anggota.activedi isi booleanopsional false mencabut peran; selain itu peran diberikan.
Contoh permintaan curl -X PUT \
-H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/json" \
-d '{"active":true}' \
"https://api.tellmelo.com/v2/roles/4e5f6a7b-8c9d-4e0f-a1b2-c3d4e5f6a7b8/members/d4c3b2a1-6e5f-4a7b-9c8d-1e2f3a4b5c6d"Jawaban Menjawab dengan satu Ok
Contoh {
"ok": true
}Status yang mungkin: 200400401403404429
POST /v2/communities/{id}/channelsMembuat kanal obrolan.
Parameter Nama Tipe Arti iddi path stringwajib id sebuah grup.namedi isi stringopsional Nama, tanpa #; kosong untuk nama yang diberikan aplikasi dalam tiap bahasa. topicdi isi stringopsional Topik yang tampil di atas kanal. categorydi isi stringopsional id kategori tempat kanal masuk; kosong untuk tanpa kategori.emojidi isi stringopsional Emoji sebagai simbol. icondi isi stringopsional Simbol dari set aplikasi, dengan namanya.homehashmegaphonevolumemessagehelpinfobellcalendarbookbookmarkpinshieldstarheartsparklesflamezaptrophygiftrocketlightbulbcodewrenchbriefcasegraduationpalettecamerafilmmusicgamepaddumbbellleafflowerpawsunmooncloudglobemapcoffeepizzasmile imagedi isi stringopsional Id gambar yang kamu unggah dengan /media/emoji. colordi isi stringopsional Warna petak.brandindigovioletroseambergreentealred shapedi isi stringopsional Bentuk petak; tanpa itu lingkaran.circlesquaretrianglediamondhexagonoctagonshieldstar
Contoh permintaan curl -X POST \
-H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/json" \
-d '{"name":"harvest","emoji":"🌻","color":"amber"}' \
"https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/channels"Jawaban Menjawab dengan satu Made
Contoh {
"id": "0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a"
}Status yang mungkin: 200400401403404429
PUT /v2/channels/{id}Mengubah nama, topik, dan kategori sebuah kanal.
Mengganti nama, topik, dan kategori; yang kamu lewatkan menjadi kosong.
Parameter Nama Tipe Arti iddi path stringwajib id sebuah kanal.namedi isi stringopsional Nama, tanpa #; kosong untuk nama yang diberikan aplikasi dalam tiap bahasa. topicdi isi stringopsional Topik yang tampil di atas kanal. categorydi isi stringopsional id kategori tempat kanal masuk; kosong untuk tanpa kategori.emojidi isi stringopsional Emoji sebagai simbol. icondi isi stringopsional Simbol dari set aplikasi, dengan namanya.homehashmegaphonevolumemessagehelpinfobellcalendarbookbookmarkpinshieldstarheartsparklesflamezaptrophygiftrocketlightbulbcodewrenchbriefcasegraduationpalettecamerafilmmusicgamepaddumbbellleafflowerpawsunmooncloudglobemapcoffeepizzasmile imagedi isi stringopsional Id gambar yang kamu unggah dengan /media/emoji. colordi isi stringopsional Warna petak.brandindigovioletroseambergreentealred shapedi isi stringopsional Bentuk petak; tanpa itu lingkaran.circlesquaretrianglediamondhexagonoctagonshieldstar
Contoh permintaan curl -X PUT \
-H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/json" \
-d '{"name":"harvest","emoji":"🌻","color":"amber"}' \
"https://api.tellmelo.com/v2/channels/0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a"Jawaban Menjawab dengan satu Made
Contoh {
"id": "0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a"
}Status yang mungkin: 200400401403404429
DELETE /v2/channels/{id}Menghapus kanal obrolan beserta pesannya.
Kanal feed tidak bisa dihapus, hanya dimatikan.
Parameter Nama Tipe Arti iddi path stringwajib id sebuah kanal.
Contoh permintaan curl -X DELETE \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/channels/0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a"Jawaban Menjawab dengan satu Ok
Contoh {
"ok": true
}Status yang mungkin: 200400401403404429
PUT /v2/communities/{id}/channels/orderMenetapkan urutan kategori dan kanal obrolan.
Parameter Nama Tipe Arti iddi path stringwajib id sebuah grup.categoriesdi isi string[]wajib id semua kategori grup dalam urutan baru.channelsdi isi string[]wajib id semua kanal obrolan grup dalam urutan baru.
Contoh permintaan curl -X PUT \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/channels/order"Jawaban Menjawab dengan satu Ok
Contoh {
"ok": true
}Status yang mungkin: 200400401403404429
PUT /v2/communities/{id}/channels/shapeMenetapkan bentuk semua simbol kanal grup.
Hanya pimpinan grup.
Parameter Nama Tipe Arti iddi path stringwajib id sebuah grup.shapedi isi stringopsional Bentuk semua simbol grup; jika dihilangkan, tiap kanal punya sendiri.circlesquaretrianglediamondhexagonoctagonshieldstar
Contoh permintaan curl -X PUT \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/channels/shape"Jawaban Menjawab dengan satu Ok
Contoh {
"ok": true
}Status yang mungkin: 200400401403404429
GET /v2/channels/{id}/overridesApa yang boleh dilakukan peran secara berbeda di sebuah kanal dibanding di grup.
Hak groups dengan ETag sejak v2.15 Parameter Nama Tipe Arti iddi path stringwajib id sebuah kanal.
Contoh permintaan curl \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/channels/0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a/overrides"Jawaban Menjawab dengan satu halaman ChannelOverride
Contoh {
"items": [
{
"role": "4e5f6a7b-8c9d-4e0f-a1b2-c3d4e5f6a7b8",
"allow": [
"send"
],
"deny": []
}
],
"next": null
}Status yang mungkin: 200304400401403404429
PUT /v2/channels/{id}/overrides/{role}Menetapkan apa yang boleh dilakukan peran secara berbeda di sebuah kanal.
Tidak untuk peran yang setara atau di atas peran tertinggimu.
Parameter Nama Tipe Arti iddi path stringwajib id sebuah kanal.roledi path stringwajib id sebuah peran.allowdi isi string[]opsional Apa yang juga boleh dilakukan peran di sini: di chat view, send, attach, mention_everyone, moderate, di kanal feed view dan post_feed. denydi isi string[]opsional Apa yang tidak boleh dilakukan peran ini di sini, dari hak yang sama. Kedua daftar kosong menghapus perbedaannya.
Contoh permintaan curl -X PUT \
-H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/json" \
-d '{"allow":["view"],"deny":["send"]}' \
"https://api.tellmelo.com/v2/channels/0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a/overrides/4e5f6a7b-8c9d-4e0f-a1b2-c3d4e5f6a7b8"Jawaban Menjawab dengan satu Ok
Contoh {
"ok": true
}Status yang mungkin: 200400401403404429
POST /v2/communities/{id}/categoriesMembuat kategori untuk kanal.
Parameter Nama Tipe Arti iddi path stringwajib id sebuah grup.namedi isi stringwajib Nama kategori. emojidi isi stringopsional Emoji sebagai simbol. icondi isi stringopsional Simbol dari set aplikasi, dengan namanya.homehashmegaphonevolumemessagehelpinfobellcalendarbookbookmarkpinshieldstarheartsparklesflamezaptrophygiftrocketlightbulbcodewrenchbriefcasegraduationpalettecamerafilmmusicgamepaddumbbellleafflowerpawsunmooncloudglobemapcoffeepizzasmile imagedi isi stringopsional Id gambar yang kamu unggah dengan /media/emoji. colordi isi stringopsional Warna petak.brandindigovioletroseambergreentealred
Contoh permintaan curl -X POST \
-H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/json" \
-d '{"name":"Garden","emoji":"🌻","color":"amber"}' \
"https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/categories"Jawaban Menjawab dengan satu Made
Contoh {
"id": "0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a"
}Status yang mungkin: 200400401403404429
PUT /v2/categories/{id}Mengganti nama kategori.
Parameter Nama Tipe Arti iddi path stringwajib id sebuah kategori.namedi isi stringwajib Nama kategori. emojidi isi stringopsional Emoji sebagai simbol. icondi isi stringopsional Simbol dari set aplikasi, dengan namanya.homehashmegaphonevolumemessagehelpinfobellcalendarbookbookmarkpinshieldstarheartsparklesflamezaptrophygiftrocketlightbulbcodewrenchbriefcasegraduationpalettecamerafilmmusicgamepaddumbbellleafflowerpawsunmooncloudglobemapcoffeepizzasmile imagedi isi stringopsional Id gambar yang kamu unggah dengan /media/emoji. colordi isi stringopsional Warna petak.brandindigovioletroseambergreentealred
Contoh permintaan curl -X PUT \
-H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/json" \
-d '{"name":"Garden","emoji":"🌻","color":"amber"}' \
"https://api.tellmelo.com/v2/categories/9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d"Jawaban Menjawab dengan satu Made
Contoh {
"id": "0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a"
}Status yang mungkin: 200400401403404429
DELETE /v2/categories/{id}Menghapus kategori.
Kanalnya tetap ada, tanpa kategori.
Parameter Nama Tipe Arti iddi path stringwajib id sebuah kategori.
Contoh permintaan curl -X DELETE \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/categories/9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d"Jawaban Menjawab dengan satu Ok
Contoh {
"ok": true
}Status yang mungkin: 200400401403404429
PUT /v2/communities/{id}/feedMenyalakan atau mematikan kanal feed sebuah grup.
Saat mati, postingan tetap tersimpan tetapi hanya penulisnya yang bisa melihat.
Parameter Nama Tipe Arti iddi path stringwajib id sebuah grup.ondi isi booleanwajib true menyalakan kanal feed, false mematikannya.
Contoh permintaan curl -X PUT \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/feed"Jawaban Menjawab dengan satu Ok
Contoh {
"ok": true
}Status yang mungkin: 200400401403404429
GET /v2/communities/{id}/invitesTautan undangan sebuah grup yang masih berlaku.
Hak groups dengan ETag sejak v2.15 Pengurus melihat semuanya, yang lain hanya miliknya sendiri.
Parameter Nama Tipe Arti iddi path stringwajib id sebuah grup.
Contoh permintaan curl \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/invites"Jawaban Menjawab dengan satu halaman InviteLink
Contoh {
"items": [
{
"code": "k7Qm2xPa",
"url": "https://tellmelo.com/groups?join=k7Qm2xPa",
"createdBy": {
"id": "d4c3b2a1-6e5f-4a7b-9c8d-1e2f3a4b5c6d",
"handle": "jon",
"name": "Jon",
"bot": false
},
"createdAt": 1758624000000,
"expiresAt": 1759228800000,
"uses": 3,
"maxUses": 10
}
],
"next": null
}Status yang mungkin: 200304400401403404429
POST /v2/communities/{id}/invitesMembuat tautan undangan.
Tautan hanya berlaku selama kamu boleh mengundang, dan hilang saat kamu keluar.
Parameter Nama Tipe Arti iddi path stringwajib id sebuah grup.daysdi isi integeropsional Berapa hari tautan berlaku; tanpa ini, sampai ditarik.1730 usesdi isi integeropsional Berapa kali tautan bisa dipakai; tanpa ini, tanpa batas.151025100
Contoh permintaan curl -X POST \
-H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/json" \
-d '{"days":7,"uses":10}' \
"https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/invites"Jawaban Menjawab dengan satu Made
Contoh {
"id": "0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a"
}Status yang mungkin: 200400401403404429
DELETE /v2/invites/{code}Menarik tautan undangan.
Parameter Nama Tipe Arti codedi path stringwajib Kode tautan undangan, bagian akhir alamatnya.
Contoh permintaan curl -X DELETE \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/invites/k7Qm2xPa"Jawaban Menjawab dengan satu Ok
Contoh {
"ok": true
}Status yang mungkin: 200400401403404429
POST /v2/channel-messages/{id}/removeMenghapus pesan anggota lain dari sebuah kanal.
Tercatat di log grup dan paling banyak 60 per jam, seperti di aplikasi.
Parameter Nama Tipe Arti iddi path stringwajib id sebuah pesan di kanal obrolan.
Contoh permintaan curl -X POST \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/channel-messages/61a2b3c4-d5e6-4f70-8192-a3b4c5d6e7f8/remove"Jawaban Menjawab dengan satu Ok
Contoh {
"ok": true
}Status yang mungkin: 200400401403404429
POST /v2/communities/{id}/posts/{post}/removeMenghapus postingan dari sebuah grup.
Tercatat di log grup dan paling banyak 60 per jam, seperti di aplikasi.
Parameter Nama Tipe Arti iddi path stringwajib id sebuah grup.postdi path stringwajib id sebuah postingan.reasondi isi stringwajib Alasan yang dibaca anggota.
Contoh permintaan curl -X POST \
-H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/json" \
-d '{"reason":"Advertising for another site, despite rule 2."}' \
"https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/posts/post/remove"Jawaban Menjawab dengan satu Ok
Contoh {
"ok": true
}Status yang mungkin: 200400401403404429
DELETE /v2/communities/{id}/members/{member}Mengeluarkan anggota dari grup.
Sejak 2.16 ini mengeluarkan: anggota bisa kembali. Yang harus tetap di luar, diblokir.
Hanya dengan hak untuk itu dan hanya untuk anggota di bawah peran tertinggimu; wakil pimpinan hanya sebagai pendiri.
Tercatat di log grup dan paling banyak 60 per jam, seperti di aplikasi.
Parameter Nama Tipe Arti iddi path stringwajib id sebuah grup.memberdi path stringwajib id akun seorang anggota.reasondi isi stringwajib Alasan yang dibaca anggota.
Contoh permintaan curl -X DELETE \
-H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/json" \
-d '{"reason":"Advertising for another site, despite rule 2."}' \
"https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/members/d4c3b2a1-6e5f-4a7b-9c8d-1e2f3a4b5c6d"Jawaban Menjawab dengan satu Ok
Contoh {
"ok": true
}Status yang mungkin: 200400401403404429
PUT /v2/communities/{id}/members/{member}/timeoutMembisukan anggota.
Pembisuan baru menggantikan yang sedang berjalan. Keluar lalu bergabung lagi tidak mengakhirinya.
Hanya dengan hak untuk itu dan hanya untuk anggota di bawah peran tertinggimu; wakil pimpinan hanya sebagai pendiri.
Tercatat di log grup dan paling banyak 60 per jam, seperti di aplikasi.
Parameter Nama Tipe Arti iddi path stringwajib id sebuah grup.memberdi path stringwajib id akun seorang anggota.secondsdi isi integerwajib Berapa lama, dalam detik.60300600360086400604800 reasondi isi stringopsional Alasan yang dibaca anggota; opsional.
Contoh permintaan curl -X PUT \
-H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/json" \
-d '{"seconds":600}' \
"https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/members/d4c3b2a1-6e5f-4a7b-9c8d-1e2f3a4b5c6d/timeout"Jawaban Menjawab dengan satu Until
Contoh {
"until": 1758624600000
}Status yang mungkin: 200400401403404429
DELETE /v2/communities/{id}/members/{member}/timeoutMencabut pembisuan.
Parameter Nama Tipe Arti iddi path stringwajib id sebuah grup.memberdi path stringwajib id akun seorang anggota.
Contoh permintaan curl -X DELETE \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/members/d4c3b2a1-6e5f-4a7b-9c8d-1e2f3a4b5c6d/timeout"Jawaban Menjawab dengan satu Until
Contoh {
"until": 1758624600000
}Status yang mungkin: 200400401403404429
GET /v2/communities/{id}/bansBlokir yang sedang berlaku di sebuah grup.
Hak groups dengan ETag sejak v2.16 Parameter Nama Tipe Arti iddi path stringwajib id sebuah grup.
Contoh permintaan curl \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/bans"Jawaban Menjawab dengan satu halaman Ban
Contoh {
"items": [
{
"member": {
"id": "d4c3b2a1-6e5f-4a7b-9c8d-1e2f3a4b5c6d",
"handle": "jon",
"name": "Jon",
"bot": false
},
"until": 1759228800000,
"createdAt": 1758624000000,
"by": "Mara 🌻"
}
],
"next": null
}Status yang mungkin: 200304400401403404429
PUT /v2/communities/{id}/bans/{member}Memblokir anggota.
Tanpa days, blokir berlaku sampai dicabut.
Hanya dengan hak untuk itu dan hanya untuk anggota di bawah peran tertinggimu; wakil pimpinan hanya sebagai pendiri.
Tercatat di log grup dan paling banyak 60 per jam, seperti di aplikasi.
Parameter Nama Tipe Arti iddi path stringwajib id sebuah grup.memberdi path stringwajib id akun seorang anggota.daysdi isi integeropsional Berapa lama, dalam hari; kosongkan untuk blokir tanpa akhir.1730 reasondi isi stringwajib Alasan yang dibaca anggota.
Contoh permintaan curl -X PUT \
-H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/json" \
-d '{"days":7,"reason":"Advertising for another site, despite rule 2."}' \
"https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/bans/d4c3b2a1-6e5f-4a7b-9c8d-1e2f3a4b5c6d"Jawaban Menjawab dengan satu Until
Contoh {
"until": 1758624600000
}Status yang mungkin: 200400401403404429
DELETE /v2/communities/{id}/bans/{member}Mencabut blokir.
Parameter Nama Tipe Arti iddi path stringwajib id sebuah grup.memberdi path stringwajib id akun seorang anggota.
Contoh permintaan curl -X DELETE \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/bans/d4c3b2a1-6e5f-4a7b-9c8d-1e2f3a4b5c6d"Jawaban Menjawab dengan satu Ok
Contoh {
"ok": true
}Status yang mungkin: 200400401403404429
GET /v2/communities/{id}/logLog pengurus: siapa menghapus apa dan mengapa.
Hak groups dengan ETag sejak v2.15 Parameter Nama Tipe Arti iddi path stringwajib id sebuah grup.
Contoh permintaan curl \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/log"Jawaban Menjawab dengan satu halaman LogEntry
Contoh {
"items": [
{
"id": "8f7e6d5c-4b3a-4291-8f7e-6d5c4b3a2918",
"action": "message_removed",
"member": {
"id": "d4c3b2a1-6e5f-4a7b-9c8d-1e2f3a4b5c6d",
"handle": "jon",
"name": "Jon",
"bot": false
},
"reason": "",
"by": "Mara 🌻",
"createdAt": 1758710400000
}
],
"next": null
}Status yang mungkin: 200304400401403404429
POST /v2/communitiesMendirikan grup. Menjawab dengan id-nya; kamu pendirinya.
Butuh izin groups. Tanpa keterangan, grup bersifat internal dan bebas bergabung; grup tersembunyi hanya dengan undangan. Boleh tidaknya anggota mendirikan grup ditentukan operator.
Parameter Nama Tipe Arti namedi isi stringwajib Namanya, paling banyak 60 karakter. descriptiondi isi stringopsional Deskripsinya, paling banyak 240 karakter. handledi isi stringopsional Nama singkat untuk sebutan @# dan tautan: 3 sampai 30 huruf kecil, angka, atau _. tagsdi isi string[]opsional Hingga 5 #tag tentang topik grup. joinPolicydi isi stringopsional Cara bergabung: open bebas, application dengan lamaran, invite hanya dengan undangan.openapplicationinvite visibilitydi isi stringopsional Siapa yang melihat grup: open semua orang, internal isinya hanya anggota, hidden sama sekali hanya anggota.openinternalhidden
Contoh permintaan curl -X POST \
-H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/json" \
-d '{"name":"Seed swap","handle":"seedswap","tags":["garden","seeds"],"joinPolicy":"open","visibility":"open"}' \
"https://api.tellmelo.com/v2/communities"Jawaban Menjawab dengan satu Made
Contoh {
"id": "0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a"
}Status yang mungkin: 200400401403429
PUT /v2/communities/{id}Mengubah grup yang kamu pimpin. Yang tidak kamu isi tetap sama.
Butuh izin groups dan memimpin grup. Kepemimpinan, pembubaran, dan keuntungan percikan tetap di aplikasi.
Parameter Nama Tipe Arti iddi path stringwajib id sebuah grup.namedi isi stringopsional Namanya, paling banyak 60 karakter. descriptiondi isi stringopsional Deskripsinya, paling banyak 240 karakter. handledi isi stringopsional Nama singkat untuk sebutan @# dan tautan: 3 sampai 30 huruf kecil, angka, atau _. tagsdi isi string[]opsional Hingga 5 #tag tentang topik grup. joinPolicydi isi stringopsional Cara bergabung: open bebas, application dengan lamaran, invite hanya dengan undangan.openapplicationinvite visibilitydi isi stringopsional Siapa yang melihat grup: open semua orang, internal isinya hanya anggota, hidden sama sekali hanya anggota.openinternalhidden imagedi isi stringopsional id gambar yang diunggah (POST /me/pictures) sebagai gambar grup. Kosong menghapusnya.bannerdi isi stringopsional id gambar yang diunggah sebagai sampul grup. Kosong menghapusnya.
Contoh permintaan curl -X PUT \
-H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/json" \
-d '{"name":"Seed swap","handle":"seedswap","tags":["garden","seeds"],"joinPolicy":"open","visibility":"open"}' \
"https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60"Jawaban Menjawab dengan satu Ok
Contoh {
"ok": true
}Status yang mungkin: 200400401403404429
Bot Apa yang terjadi di grup sebuah bot, secara langsung: sebagai aliran, halaman demi halaman, atau dikirim ke alamat.
GET /v2/eventsPeristiwa dari grup bot sejak suatu peristiwa, halaman demi halaman.
Hanya dengan token bot. Peristiwa kanal hanya jika bot boleh melihatnya.
Peristiwa disimpan sehari. next adalah nomor yang terakhir, sebagai since untuk halaman berikutnya.
Parameter Nama Tipe Arti sincedi query stringopsional Nomor peristiwa terakhir yang sudah dimiliki bot. Tanpa itu, aliran mulai sekarang dan daftar dari yang tertua.
Contoh permintaan curl \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/events?since=0"Jawaban Menjawab dengan satu halaman BotEvent
Contoh {
"items": [
{
"id": "4711",
"type": "message.created",
"community": "c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60",
"channel": "0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a",
"createdAt": 1758634800000,
"data": {
"message": {
"id": "61a2b3c4-d5e6-4f70-8192-a3b4c5d6e7f8",
"text": "/dice 6",
"author": {
"id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
"handle": "mara",
"name": "Mara 🌻",
"bot": false
},
"media": 0,
"replyTo": null,
"threadOf": null,
"createdAt": 1758634800000
}
}
}
],
"next": null
}Status yang mungkin: 200401429
GET /v2/events/streamPeristiwa dari grup bot begitu terjadi (server-sent events).
Hak read dengan ETag sejak v2.20 Koneksi tetap terbuka dan ditutup setelah sepuluh menit; klien menyambung lagi dan mengirim Last-Event-ID.
Hanya dengan token bot. Peristiwa kanal hanya jika bot boleh melihatnya.
Parameter Nama Tipe Arti sincedi query stringopsional Nomor peristiwa terakhir yang sudah dimiliki bot. Tanpa itu, aliran mulai sekarang dan daftar dari yang tertua.
Contoh permintaan curl \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/events/stream?since=0"Jawaban Menjawab dengan satu BotEvent
Contoh {
"id": "4711",
"type": "message.created",
"community": "c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60",
"channel": "0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a",
"createdAt": 1758634800000,
"data": {
"message": {
"id": "61a2b3c4-d5e6-4f70-8192-a3b4c5d6e7f8",
"text": "/dice 6",
"author": {
"id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
"handle": "mara",
"name": "Mara 🌻",
"bot": false
},
"media": 0,
"replyTo": null,
"threadOf": null,
"createdAt": 1758634800000
}
}
}Status yang mungkin: 200304401429
GET /v2/me/commandsPerintah bot.
Hak read dengan ETag sejak v2.20 Hanya dengan token bot. Peristiwa kanal hanya jika bot boleh melihatnya.
Contoh permintaan curl \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/me/commands"Jawaban Menjawab dengan satu halaman BotCommand
Contoh {
"items": [
{
"name": "dice",
"description": "Rolls a die"
}
],
"next": null
}Status yang mungkin: 200304401429
PUT /v2/me/commandsMenetapkan perintah bot, semuanya sekaligus.
Mengganti semua perintah; daftar kosong menghapusnya. Di obrolan yang boleh dilihat bot, kolom input menawarkannya setelah “/”.
Parameter Nama Tipe Arti commandsdi isi object[]wajib Hingga 25 perintah, masing-masing { name, description }.
Contoh permintaan curl -X PUT \
-H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/json" \
-d '{"commands":[{"name":"dice","description":"Rolls a die"}]}' \
"https://api.tellmelo.com/v2/me/commands"Jawaban Menjawab dengan satu halaman BotCommand
Contoh {
"items": [
{
"name": "dice",
"description": "Rolls a die"
}
],
"next": null
}Status yang mungkin: 200400401403429
POST /v2/interactions/{id}/replyMenjawab perintah atau tombol.
Dalam 15 menit setelah peristiwa command atau interaction; dengan private, hanya yang memakai perintah atau tombol yang melihat jawabannya.
Parameter Nama Tipe Arti iddi path stringwajib Id dari peristiwa (data.interaction). textdi isi stringopsional Teks postingan, balasan, atau pesan. privatedi isi booleanopsional true: hanya yang memakai perintah atau tombol yang melihat jawabannya, selama sehari.carddi isi objectopsional Kartu { title, text, color, fields: [{ name, value }] }, paling banyak 10 bidang. buttonsdi isi object[]opsional Hingga 5 tombol, masing-masing { id, label, style } dengan style primary, secondary, atau danger. Tekanan datang sebagai peristiwa interaction.
Contoh permintaan curl -X POST \
-H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/json" \
-d '{"text":"You rolled a 4.","private":true}' \
"https://api.tellmelo.com/v2/interactions/9b8c7d6e-5f4a-4b3c-8d2e-1f0a9b8c7d6e/reply"Jawaban Menjawab dengan satu Made
Contoh {
"id": "0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a"
}Status yang mungkin: 200400401403404429
POST /v2/channels/{id}/voiceMengambil tempat di kanal suara untuk memutar musik atau suara.
Hanya dengan token bot, sejauh diizinkan perannya di kanal. Program tersambung dengan SDK LiveKit dan mengirim suaranya sebagai mikrofon; setiap orang mengatur volumenya sendiri.
Parameter Nama Tipe Arti iddi path stringwajib id sebuah kanal.
Contoh permintaan curl -X POST \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/channels/0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a/voice"Jawaban Menjawab dengan satu VoiceSeat
Contoh {
"url": "wss://voice.example.org",
"token": "eyJhbGciOiJIUzI1NiJ9…",
"iceServers": [
{
"urls": [
"stun:turn.example.org:3478"
]
}
],
"speak": true,
"video": false
}Status yang mungkin: 200400401403404429
Jelajahi Tren, pencarian, dan emoji milik instans.
GET /v2/tagsTag yang sedang ramai.
Hak read dengan ETag sejak v2.0 Maksimal 10 tag tren menurut skor: setiap pemakaian bernilai 1 dan berkurang separuh setiap 3 hari, satu akun bernilai maksimal 3 per hari. posts adalah skor yang dibulatkan. limit hanya memperpendek daftar. Tag yang disorot tim bisa berada lebih atas.
Parameter Nama Tipe Arti limitdi query integeropsional Entri per halaman: 20 secara bawaan, maksimal 50.
Contoh permintaan curl \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/tags?limit=10"Jawaban Menjawab dengan satu halaman Tag
Contoh {
"items": [
{
"tag": "garden",
"posts": 58
}
],
"next": null
}Status yang mungkin: 200304401429
GET /v2/searchPencarian di postingan, nama, nama pendek, dan tag.
Hak read dengan ETag sejak v2.0 Hanya mencari konten publik: postingan di luar grup, profil, dan tag. limit berlaku per jenis.
Parameter Nama Tipe Arti qdi query stringwajib Kata yang dicari. typedi query stringopsional Jenis hasil mana. Tanpa itu, semua jenis.allpostsprofilestags limitdi query integeropsional Entri per halaman: 20 secara bawaan, maksimal 50.
Contoh permintaan curl \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/search?q=garden&type=posts"Jawaban Menjawab dengan satu SearchResult
Contoh {
"posts": [
{
"id": "5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1",
"text": "The bees are back in the garden 🐝 #garden",
"kind": "poll",
"author": {
"id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
"handle": "mara",
"name": "Mara 🌻",
"verified": true,
"accountKind": "person"
},
"community": {
"id": "c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60",
"name": "Urban Gardening"
},
"media": [
{
"url": "/api/media?id=b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918",
"kind": "image",
"poster": null,
"ai": "without"
}
],
"poll": {
"options": [
{
"text": "Lavender",
"votes": 12
},
{
"text": "Sunflowers",
"votes": 7
},
{
"text": "Clover",
"votes": 3
}
],
"total": 22,
"multiple": false,
"endsAt": null,
"running": true,
"resultsVisible": true,
"myVotes": [
0
]
},
"quotes": null,
"continues": null,
"counts": {
"replies": 4,
"likes": 31,
"reposts": 2
},
"pinned": false,
"giftDrop": {
"item": "plan",
"quantity": 3,
"places": 10,
"left": 4,
"audience": "followers",
"newAccounts": false,
"status": "open",
"claimed": true
},
"createdAt": 1758624000000
}
],
"profiles": [
{
"id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
"handle": "mara",
"name": "Mara 🌻",
"verified": true,
"accountKind": "person"
}
],
"tags": [
{
"tag": "garden",
"posts": 58
}
]
}Status yang mungkin: 200304400401429
GET /v2/emojisEmoji milik instans, dengan alamat gambarnya.
Hak read dengan ETag sejak v2.1 Di teks, emoji muncul sebagai :name:. Ganti dengan gambar dari daftar ini; nama yang tidak dikenal tetap teks.
Contoh permintaan curl \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/emojis"Jawaban Menjawab dengan satu halaman Emoji
Contoh {
"items": [
{
"name": "tellmelo",
"url": "/api/media?id=e1f2a3b4-c5d6-4e7f-8a9b-0c1d2e3f4a5b"
}
],
"next": null
}Status yang mungkin: 200304401429
GIF dan video Perpustakaan media: cari GIF dan video yang dibagikan, unggah dan kelola milikmu, dan sematkan di situs web lain.
GET /v2/mediaGIF atau video yang dibagikan, yang paling sering dipakai lebih dulu.
Hak read berhalaman dengan ETag sejak v2.14 Tanpa akun yang kamu blokir atau yang memblokirmu. Muat url dan poster dengan kunci di header, untuk postingan di tellmelo.
Untuk situs web lain hanya yang punya embed: alamatnya berfungsi tanpa kunci, di browser apa pun.
Parameter Nama Tipe Arti kinddi query stringopsional gif atau video; jika tidak diisi, gif.gifvideoqdi query stringopsional Kata yang ada di nama atau kata kunci. anywheredi query booleanopsional true: hanya yang juga boleh muncul di situs web lain.limitdi query integeropsional Entri per halaman: 20 secara bawaan, maksimal 50. cursordi query stringopsional next dari jawaban sebelumnya. Tanpa itu, dari awal.
Contoh permintaan curl \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/media?kind=gif&q=bees&anywhere=true&limit=20"Jawaban Menjawab dengan satu halaman MediaItem
Contoh {
"items": [
{
"id": "b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918",
"kind": "gif",
"name": "Happy bees",
"keywords": "bees garden happy",
"width": 480,
"height": 270,
"seconds": 0,
"url": "/api/media?id=b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918",
"poster": "/api/media?id=b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918&poster=1",
"uploader": {
"handle": "mara",
"name": "Mara 🌻"
},
"mine": false,
"shared": true,
"anywhere": true,
"embed": {
"page": "https://tellmelo.com/media-embed/b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918",
"file": "https://tellmelo.com/media-embed/b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918/file",
"poster": "https://tellmelo.com/media-embed/b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918/poster",
"code": "<iframe src=\"https://tellmelo.com/media-embed/b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918\" width=\"480\" height=\"300\" title=\"Happy bees\" style=\"border:0;max-width:100%\" loading=\"lazy\" allowfullscreen></iframe>"
}
}
],
"next": "MTc1ODYyNDAwMDAwMDo1ZjBjMmE5ZS04ZDQx"
}Status yang mungkin: 200304400401429
GET /v2/media/minePerpustakaan media milikmu, yang terbaru lebih dulu.
Hak media berhalaman dengan ETag sejak v2.14 Parameter Nama Tipe Arti kinddi query stringopsional gif atau video; jika tidak diisi, gif.gifvideoqdi query stringopsional Kata yang ada di nama atau kata kunci. limitdi query integeropsional Entri per halaman: 20 secara bawaan, maksimal 50. cursordi query stringopsional next dari jawaban sebelumnya. Tanpa itu, dari awal.
Contoh permintaan curl \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/media/mine?kind=gif&q=bees&limit=20"Jawaban Menjawab dengan satu halaman MediaItem
Contoh {
"items": [
{
"id": "b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918",
"kind": "gif",
"name": "Happy bees",
"keywords": "bees garden happy",
"width": 480,
"height": 270,
"seconds": 0,
"url": "/api/media?id=b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918",
"poster": "/api/media?id=b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918&poster=1",
"uploader": {
"handle": "mara",
"name": "Mara 🌻"
},
"mine": false,
"shared": true,
"anywhere": true,
"embed": {
"page": "https://tellmelo.com/media-embed/b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918",
"file": "https://tellmelo.com/media-embed/b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918/file",
"poster": "https://tellmelo.com/media-embed/b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918/poster",
"code": "<iframe src=\"https://tellmelo.com/media-embed/b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918\" width=\"480\" height=\"300\" title=\"Happy bees\" style=\"border:0;max-width:100%\" loading=\"lazy\" allowfullscreen></iframe>"
}
}
],
"next": "MTc1ODYyNDAwMDAwMDo1ZjBjMmE5ZS04ZDQx"
}Status yang mungkin: 200304400401403429
GET /v2/media/{id}Sebuah GIF atau video, milikmu atau yang dibagikan.
Hak read dengan ETag sejak v2.14 Parameter Nama Tipe Arti iddi path stringwajib ID GIF atau video.
Contoh permintaan curl \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/media/b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918"Jawaban Menjawab dengan satu MediaItem
Contoh {
"id": "b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918",
"kind": "gif",
"name": "Happy bees",
"keywords": "bees garden happy",
"width": 480,
"height": 270,
"seconds": 0,
"url": "/api/media?id=b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918",
"poster": "/api/media?id=b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918&poster=1",
"uploader": {
"handle": "mara",
"name": "Mara 🌻"
},
"mine": false,
"shared": true,
"anywhere": true,
"embed": {
"page": "https://tellmelo.com/media-embed/b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918",
"file": "https://tellmelo.com/media-embed/b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918/file",
"poster": "https://tellmelo.com/media-embed/b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918/poster",
"code": "<iframe src=\"https://tellmelo.com/media-embed/b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918\" width=\"480\" height=\"300\" title=\"Happy bees\" style=\"border:0;max-width:100%\" loading=\"lazy\" allowfullscreen></iframe>"
}
}Status yang mungkin: 200304400401404429
POST /v2/media/uploadsMulai unggahan.
Lalu kirim file dalam potongan maksimal piece byte ke /media/uploads/{upload}. Tanpa potongan baru, unggahan berakhir setelah 15 menit.
Batas aplikasi berlaku: GIF hingga 15 MB, video sesuai paket dalam ukuran dan durasi, GIF per hari, GIF pribadi, poin video per minggu. Jika tidak, kamu mendapat 409, 413, atau 429.
Parameter Nama Tipe Arti kinddi isi stringwajib gif atau video; jika tidak diisi, gif.gifvideosizedi isi integerwajib Ukuran seluruh file dalam byte. namedi isi stringwajib Nama untuk menemukannya: 2 sampai 40 karakter. keywordsdi isi stringopsional Kata kunci untuk pencarian, dipisahkan dengan spasi. shareddi isi booleanopsional true: dibagikan ke semua orang di tellmelo.anywheredi isi booleanopsional true: dibagikan dan juga diizinkan di situs web lain. Hanya bersama shared.
Contoh permintaan curl -X POST \
-H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/json" \
-d '{"kind":"gif","size":2400000,"name":"Happy bees","keywords":"bees garden","shared":true,"anywhere":false}' \
"https://api.tellmelo.com/v2/media/uploads"Jawaban Menjawab dengan satu UploadStarted
Contoh {
"upload": "e7c1a2b3-4d5e-4f60-8a9b-0c1d2e3f4a5b",
"piece": 4194304
}Status yang mungkin: 200400401403429
PUT /v2/media/uploads/{upload}Kirim satu potongan file.
Body-nya adalah potongan itu sendiri (application/octet-stream), bukan JSON. Jika tidak menyambung, kamu mendapat 409 dengan received: lanjutkan dari sana. Setelah potongan terakhir, file dikonversi; responsnya lalu berisi item.
Parameter Nama Tipe Arti uploaddi path stringwajib upload dari awal unggahan.offsetdi query integerwajib Posisi awal potongan dalam file, dalam byte; 0 untuk yang pertama.
Contoh permintaan curl -X PUT \
-H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/octet-stream" \
--data-binary @piece \
"https://api.tellmelo.com/v2/media/uploads/e7c1a2b3-4d5e-4f60-8a9b-0c1d2e3f4a5b?offset=0"Jawaban Menjawab dengan satu UploadPiece
Contoh {
"received": 4194304,
"item": null
}Status yang mungkin: 200400401403404429
POST /v2/media/{id}Ubah salah satu GIF atau videomu.
Parameter Nama Tipe Arti iddi path stringwajib ID GIF atau video. namedi isi stringopsional Nama untuk menemukannya: 2 sampai 40 karakter. keywordsdi isi stringopsional Kata kunci untuk pencarian, dipisahkan dengan spasi. shareddi isi booleanopsional true: dibagikan ke semua orang di tellmelo.anywheredi isi booleanopsional true: dibagikan dan juga diizinkan di situs web lain. Hanya bersama shared.
Contoh permintaan curl -X POST \
-H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/json" \
-d '{"name":"Happy bees","anywhere":true}' \
"https://api.tellmelo.com/v2/media/b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918"Jawaban Menjawab dengan satu Ok
Contoh {
"ok": true
}Status yang mungkin: 200400401403404429
DELETE /v2/media/{id}Hapus salah satu GIF atau videomu.
Postingan yang sudah menampilkannya tetap menyimpannya. Di situs web lain, itu hilang dalam beberapa menit.
Parameter Nama Tipe Arti iddi path stringwajib ID GIF atau video.
Contoh permintaan curl -X DELETE \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/media/b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918"Jawaban Menjawab dengan satu Ok
Contoh {
"ok": true
}Status yang mungkin: 200400401403404429
Akunmu Profilmu, feed-mu, emoji milikmu, dan webhook-mu.
GET /v2/meProfilmu sendiri, dengan id yang diharapkan path lain.
Hak read dengan ETag sejak v2.0 Contoh permintaan curl \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/me"Jawaban Menjawab dengan satu Profile
Contoh {
"id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
"handle": "mara",
"name": "Mara 🌻",
"verified": true,
"accountKind": "person",
"about": "Beekeeper, allotment, too many seeds. :tellmelo:",
"website": "https://mara-imkerei.example/",
"websiteVerified": true,
"followers": 148,
"createdAt": 1750848000000
}Status yang mungkin: 200304401429
GET /v2/feedFeed-mu sendiri, seperti yang disusun aplikasi.
Hak read berhalaman sejak v2.0 Tanpa ETag, karena urutannya terus berubah. Daftar yang sudah kamu mulai tetap sama sampai akhir.
Parameter Nama Tipe Arti tabdi query stringopsional Feed mana: for-you, following, latest, atau bookmarks. latest secara bawaan.for-youfollowinglatestbookmarks tagdi query stringopsional Hanya postingan tentang tag ini: ditulis dengannya atau dikenali server di dalamnya. Tanpa itu, tanpa filter. limitdi query integeropsional Entri per halaman: 20 secara bawaan, maksimal 50. cursordi query stringopsional next dari jawaban sebelumnya. Tanpa itu, dari awal.
Contoh permintaan curl \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/feed?tab=following&limit=20"Jawaban Menjawab dengan satu halaman Post
Contoh {
"items": [
{
"id": "5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1",
"text": "The bees are back in the garden 🐝 #garden",
"kind": "poll",
"author": {
"id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
"handle": "mara",
"name": "Mara 🌻",
"verified": true,
"accountKind": "person"
},
"community": {
"id": "c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60",
"name": "Urban Gardening"
},
"media": [
{
"url": "/api/media?id=b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918",
"kind": "image",
"poster": null,
"ai": "without"
}
],
"poll": {
"options": [
{
"text": "Lavender",
"votes": 12
},
{
"text": "Sunflowers",
"votes": 7
},
{
"text": "Clover",
"votes": 3
}
],
"total": 22,
"multiple": false,
"endsAt": null,
"running": true,
"resultsVisible": true,
"myVotes": [
0
]
},
"quotes": null,
"continues": null,
"counts": {
"replies": 4,
"likes": 31,
"reposts": 2
},
"pinned": false,
"giftDrop": {
"item": "plan",
"quantity": 3,
"places": 10,
"left": 4,
"audience": "followers",
"newAccounts": false,
"status": "open",
"claimed": true
},
"createdAt": 1758624000000
}
],
"next": "MTc1ODYyNDAwMDAwMDo1ZjBjMmE5ZS04ZDQx"
}Status yang mungkin: 200400401429
POST /v2/me/picturesMengunggah gambar sebagai byte. Menjawab dengan id dan url; lalu id dipakai sebagai foto profil, sampul, atau di postingan.
PNG, JPEG, WebP, atau GIF, dikenali dari byte pertamanya; disimpan ulang tanpa metadata. Gambar yang tidak dipakai di mana pun akan dihapus nanti.
Contoh permintaan curl -X POST \
-H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/octet-stream" \
--data-binary @picture.png \
"https://api.tellmelo.com/v2/me/pictures"Jawaban Menjawab dengan satu Picture
Contoh {
"id": "8c7b6a59-4837-4261-9f5e-d4c3b2a1f0e9",
"url": "/api/media?id=8c7b6a59-4837-4261-9f5e-d4c3b2a1f0e9"
}Status yang mungkin: 200401403429
PUT /v2/me/profileMengubah profilmu: nama, tentang kamu, foto profil, sampul, dan warna profil. Yang tidak kamu isi tetap sama.
Butuh izin profile. @nama-mu tetap di aplikasi: itu juga nama masukmu.
Parameter Nama Tipe Arti namedi isi stringopsional Nama tampilan, paling banyak 60 karakter. aboutdi isi stringopsional Teks “Tentang kamu”. avatardi isi stringopsional id gambar yang diunggah sebagai foto profil. Kosong menghapusnya.bannerdi isi stringopsional id gambar yang diunggah sebagai sampul. Kosong menghapusnya.colordi isi stringopsional Warna profil, dengan paket. null menghapusnya.indigovioletrosecoralamberlimegreentealskyslatesandnight
Contoh permintaan curl -X PUT \
-H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/json" \
-d '{"name":"Mara 🌻","about":"Gardening in the city.","avatar":"8c7b6a59-4837-4261-9f5e-d4c3b2a1f0e9"}' \
"https://api.tellmelo.com/v2/me/profile"Jawaban Menjawab dengan satu Ok
Contoh {
"ok": true
}Status yang mungkin: 200400401403429
GET /v2/me/emojisEmoji milikmu sendiri.
Hak read dengan ETag sejak v2.19 Contoh permintaan curl \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/me/emojis"Jawaban Menjawab dengan satu halaman OwnEmoji
Contoh {
"items": [
{
"name": "sunflower",
"url": "/api/media?id=8c7b6a59-4837-4261-9f5e-d4c3b2a1f0e9",
"animated": false,
"resting": false
}
],
"next": null
}Status yang mungkin: 200304401429
POST /v2/me/emojis/picturesMengunggah gambar untuk emoji milikmu sebagai byte.
Emoji bergerak butuh paket. Jika terlalu besar setelah dikonversi, gambar ditolak.
Contoh permintaan curl -X POST \
-H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/octet-stream" \
--data-binary @picture.png \
"https://api.tellmelo.com/v2/me/emojis/pictures"Jawaban Menjawab dengan satu EmojiPicture
Contoh {
"id": "8c7b6a59-4837-4261-9f5e-d4c3b2a1f0e9",
"url": "/api/media?id=8c7b6a59-4837-4261-9f5e-d4c3b2a1f0e9",
"animated": false
}Status yang mungkin: 200401403429
POST /v2/me/emojisMembuat emoji milikmu. Menjawab dengan semua emojimu.
Berapa banyak emoji yang bisa kamu buat tergantung paket.
Parameter Nama Tipe Arti namedi isi stringwajib Nama yang kamu pakai untuk menulis emoji, seperti :nama:. picturedi isi stringwajib id dari POST /me/emojis/pictures.
Contoh permintaan curl -X POST \
-H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/json" \
-d '{"name":"sunflower","picture":"8c7b6a59-4837-4261-9f5e-d4c3b2a1f0e9"}' \
"https://api.tellmelo.com/v2/me/emojis"Jawaban Menjawab dengan satu halaman OwnEmoji
Contoh {
"items": [
{
"name": "sunflower",
"url": "/api/media?id=8c7b6a59-4837-4261-9f5e-d4c3b2a1f0e9",
"animated": false,
"resting": false
}
],
"next": null
}Status yang mungkin: 200400401403429
DELETE /v2/me/emojis/{name}Menghapus emoji milikmu. Menjawab dengan sisanya.
Parameter Nama Tipe Arti namedi path stringwajib Nama emoji, tanpa titik dua.
Contoh permintaan curl -X DELETE \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/me/emojis/sunflower"Jawaban Menjawab dengan satu halaman OwnEmoji
Contoh {
"items": [
{
"name": "sunflower",
"url": "/api/media?id=8c7b6a59-4837-4261-9f5e-d4c3b2a1f0e9",
"animated": false,
"resting": false
}
],
"next": null
}Status yang mungkin: 200400401403404429
PUT /v2/me/emojis/sharingMenentukan apakah pengikutmu boleh memakai emojimu di teks mereka.
Parameter Nama Tipe Arti shareddi isi booleanwajib true membagikan emojimu ke pengikut, false tidak.
Contoh permintaan curl -X PUT \
-H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/json" \
-d '{"shared":true}' \
"https://api.tellmelo.com/v2/me/emojis/sharing"Jawaban Menjawab dengan satu Ok
Contoh {
"ok": true
}Status yang mungkin: 200400401403429
GET /v2/me/webhooksWebhook-mu beserta statusnya.
Hak webhooks dengan ETag sejak v2.19 Butuh izin webhooks. Webhook tersedia dengan paket organisasi atau sebagai mitra.
Contoh permintaan curl \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/me/webhooks"Jawaban Menjawab dengan satu halaman Webhook
Contoh {
"items": [
{
"id": "1f2e3d4c-5b6a-4798-8a7b-6c5d4e3f2a1b",
"url": "https://example.org/tellmelo-hook",
"kinds": [
"reply",
"mention"
],
"active": true,
"lastStatus": 200,
"lastAt": 1758624000000,
"failures": 0
}
],
"next": null
}Status yang mungkin: 200304401403429
POST /v2/me/webhooksMembuat webhook. Menjawab dengan id dan rahasia untuk tanda tangan, hanya kali ini.
Setiap pengiriman ditandatangani dengan rahasia (X-Tellmelo-Signature). Simpan; tidak akan ditampilkan lagi.
Parameter Nama Tipe Arti urldi isi stringwajib Alamat HTTPS di luar jaringan lokal, tanpa kredensial. kindsdi isi string[]wajib Hal yang diberitahukan ke webhook. Jenis yang tersedia tergantung paket dan kemitraanmu.replymentiongroup_mentionfollowlikerepostmessagequota_changedquota_giftdrop_claimeddrop_empty
Contoh permintaan curl -X POST \
-H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/json" \
-d '{"url":"https://example.org/tellmelo-hook","kinds":["reply","mention"]}' \
"https://api.tellmelo.com/v2/me/webhooks"Jawaban Menjawab dengan satu WebhookCreated
Contoh {
"id": "1f2e3d4c-5b6a-4798-8a7b-6c5d4e3f2a1b",
"secret": "whsec_3f9a…"
}Status yang mungkin: 200400401403429
DELETE /v2/me/webhooks/{id}Menghapus webhook.
Parameter Nama Tipe Arti iddi path stringwajib id webhook.
Contoh permintaan curl -X DELETE \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/me/webhooks/1f2e3d4c-5b6a-4798-8a7b-6c5d4e3f2a1b"Jawaban Menjawab dengan satu Ok
Contoh {
"ok": true
}Status yang mungkin: 200400401403404429
POST /v2/me/webhooks/{id}/testMengirim uji coba ke webhook.
Parameter Nama Tipe Arti iddi path stringwajib id webhook.
Contoh permintaan curl -X POST \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/me/webhooks/1f2e3d4c-5b6a-4798-8a7b-6c5d4e3f2a1b/test"Jawaban Menjawab dengan satu Ok
Contoh {
"ok": true
}Status yang mungkin: 200400401403404429
Notifikasi Apa yang terjadi di sekitar akunmu, halaman demi halaman.
GET /v2/notificationsNotifikasimu, yang terbaru lebih dulu.
Hak read berhalaman dengan ETag sejak v2.0 Membaca tidak menandai apa pun sudah dibaca; POST /notifications/read yang melakukannya. Peristiwa sejenis pada postingan yang sama berbagi satu baris; more menyebut berapa banyak.
Parameter Nama Tipe Arti limitdi query integeropsional Entri per halaman: 20 secara bawaan, maksimal 50. cursordi query stringopsional next dari jawaban sebelumnya. Tanpa itu, dari awal.
Contoh permintaan curl \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/notifications?limit=20"Jawaban Menjawab dengan satu halaman Notification
Contoh {
"items": [
{
"id": "3f2e1d0c-9b8a-4765-8432-10fedcba9876",
"kind": "like",
"text": null,
"actor": {
"handle": "jon",
"name": "Jon"
},
"postId": "5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1",
"read": false,
"more": 2,
"createdAt": 1758624300000,
"updatedAt": 1758624900000
}
],
"next": "MTc1ODYyNDAwMDAwMDo1ZjBjMmE5ZS04ZDQx"
}Status yang mungkin: 200304401429
POST /v2/notifications/readTandai notifikasimu sudah dibaca.
Contoh permintaan curl -X POST \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/notifications/read"Jawaban Menjawab dengan satu Ok
Contoh {
"ok": true
}Status yang mungkin: 200401403429
Pesan Kotak masuk dan percakapanmu. Percakapan dinamai menurut akun lainnya.
GET /v2/conversationsKotak masukmu: satu baris per percakapan, yang terbaru lebih dulu.
Hak read berhalaman dengan ETag sejak v2.0 Parameter Nama Tipe Arti limitdi query integeropsional Entri per halaman: 20 secara bawaan, maksimal 50. cursordi query stringopsional next dari jawaban sebelumnya. Tanpa itu, dari awal.
Contoh permintaan curl \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/conversations?limit=20"Jawaban Menjawab dengan satu halaman Conversation
Contoh {
"items": [
{
"with": "d4c3b2a1-6e5f-4a7b-9c8d-1e2f3a4b5c6d",
"handle": "jon",
"name": "Jon",
"excerpt": "See you on Saturday at the market!",
"truncated": false,
"fromMe": true,
"lastMessageId": "7c6b5a49-3827-4165-9f0e-d1c2b3a49586",
"unread": 0,
"updatedAt": 1758624060000
}
],
"next": "MTc1ODYyNDAwMDAwMDo1ZjBjMmE5ZS04ZDQx"
}Status yang mungkin: 200304401429
GET /v2/conversations/{with}/messagesPesan dalam satu percakapan, yang terbaru lebih dulu.
Hak read berhalaman dengan ETag sejak v2.0 Membaca tidak menandai apa pun sudah dibaca; POST /conversations/{with}/read yang melakukannya.
Parameter Nama Tipe Arti withdi path stringwajib id akun lainnya. Percakapan tidak punya id sendiri.limitdi query integeropsional Entri per halaman: 20 secara bawaan, maksimal 50. cursordi query stringopsional next dari jawaban sebelumnya. Tanpa itu, dari awal.
Contoh permintaan curl \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/conversations/a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05/messages?limit=20"Jawaban Menjawab dengan satu halaman Message
Contoh {
"items": [
{
"id": "7c6b5a49-3827-4165-9f0e-d1c2b3a49586",
"text": "See you on Saturday at the market!",
"from": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
"to": "d4c3b2a1-6e5f-4a7b-9c8d-1e2f3a4b5c6d",
"read": true,
"media": [],
"replyTo": null,
"createdAt": 1758624060000
}
],
"next": "MTc1ODYyNDAwMDAwMDo1ZjBjMmE5ZS04ZDQx"
}Status yang mungkin: 200304400401404429
POST /v2/conversations/{with}/messagesKirim pesan dalam percakapan.
Aturan aplikasi berlaku: yang memblokirmu tidak bisa dijangkau, dan pengaturan orang lain diperhitungkan.
Gambar, GIF, dan video tidak bisa dilampirkan ke pesan lewat API, hanya di aplikasi.
Parameter Nama Tipe Arti withdi path stringwajib id akun lainnya. Percakapan tidak punya id sendiri.textdi isi stringwajib Teks postingan, balasan, atau pesan. replyTodi isi stringopsional id pesan sebelumnya dalam percakapan ini yang dijawab pesan ini. Sejak 2.2.
Contoh permintaan curl -X POST \
-H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/json" \
-d '{"text":"See you on Saturday at the market!"}' \
"https://api.tellmelo.com/v2/conversations/a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05/messages"Jawaban Menjawab dengan satu Ok
Contoh {
"ok": true
}Status yang mungkin: 200400401403404429
POST /v2/conversations/{with}/readTandai semua pesan dalam percakapan sudah dibaca.
Parameter Nama Tipe Arti withdi path stringwajib id akun lainnya. Percakapan tidak punya id sendiri.
Contoh permintaan curl -X POST \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/conversations/a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05/read"Jawaban Menjawab dengan satu Ok
Contoh {
"ok": true
}Status yang mungkin: 200400401403404429
DELETE /v2/conversations/{with}/messages/{id}Menghapus salah satu pesanmu.
Hanya pesanmu sendiri, dan hanya dalam 24 jam setelah dikirim.
Parameter Nama Tipe Arti withdi path stringwajib id akun lainnya. Percakapan tidak punya id sendiri.iddi path stringwajib id pesan.
Contoh permintaan curl -X DELETE \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/conversations/a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05/messages/7c6b5a49-3827-4165-9f0e-d1c2b3a49586"Jawaban Menjawab dengan satu Ok
Contoh {
"ok": true
}Status yang mungkin: 200400401403404429
POST /v2/conversations/{with}/plannedMenjadwalkan pesan untuk nanti. Menjawab dengan id pesan terjadwal.
Butuh paket dengan pesan terjadwal, kalau tidak 403. Dengan enkripsi ujung ke ujung di kedua sisi, hanya bisa di aplikasi.
Parameter Nama Tipe Arti withdi path stringwajib id akun lainnya. Percakapan tidak punya id sendiri.textdi isi stringwajib Teks postingan, balasan, atau pesan. sendAtdi isi integerwajib Kapan pesan dikirim, dalam milidetik sejak 1970.
Contoh permintaan curl -X POST \
-H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/json" \
-d '{"text":"Happy birthday! 🎂","sendAt":1758700000000}' \
"https://api.tellmelo.com/v2/conversations/a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05/planned"Jawaban Menjawab dengan satu Made
Contoh {
"id": "0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a"
}Status yang mungkin: 200400401403404429
GET /v2/me/planned-messagesPesanmu yang masih akan dikirim, urut menurut waktu.
Hak read dengan ETag sejak v2.19 Parameter Nama Tipe Arti withdi query stringopsional Hanya pesan untuk akun ini (id-nya).
Contoh permintaan curl \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/me/planned-messages"Jawaban Menjawab dengan satu halaman PlannedMessage
Contoh {
"items": [
{
"id": "3b2a1c0d-9e8f-4a7b-b6c5-d4e3f2a1b0c9",
"to": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
"text": "Happy birthday! 🎂",
"sendAt": 1758710400000,
"state": "waiting"
}
],
"next": null
}Status yang mungkin: 200304401429
POST /v2/me/planned-messages/{id}/sendMengirim sekarang pesan terjadwal yang ditahan atau gagal.
Parameter Nama Tipe Arti iddi path stringwajib id pesan terjadwal.
Contoh permintaan curl -X POST \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/me/planned-messages/3b2a1c0d-9e8f-4a7b-b6c5-d4e3f2a1b0c9/send"Jawaban Menjawab dengan satu Ok
Contoh {
"ok": true
}Status yang mungkin: 200400401403404429
DELETE /v2/me/planned-messages/{id}Menghapus pesan terjadwal sebelum terkirim.
Parameter Nama Tipe Arti iddi path stringwajib id pesan terjadwal.
Contoh permintaan curl -X DELETE \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/me/planned-messages/3b2a1c0d-9e8f-4a7b-b6c5-d4e3f2a1b0c9"Jawaban Menjawab dengan satu Ok
Contoh {
"ok": true
}Status yang mungkin: 200400401403404429
Relasi Suka, simpan, posting ulang, ikuti, gabung, blokir: satu path, dipasang dan dihapus dengan active. Sejak 2.19 juga daftarnya: pengikut, yang diikuti, serta blokir dan bisukan milikmu sendiri.
POST /v2/relationsSuka, simpan, posting ulang, ikuti, gabung, blokir, bisukan, tergantung kind.
target adalah postingan untuk like, save, dan repost, grup untuk join, akun untuk follow, block, dan mute. active: false menghapus relasi.
Parameter Nama Tipe Arti kinddi isi stringwajib Relasi mana: like, save, repost, follow, join, block, atau mute (sejak 2.2).likesaverepostfollowjoinblockmute targetdi isi stringwajib id postingan, profil, atau grup, tergantung kind.activedi isi booleanopsional true memasang relasi, false menghapusnya.
Contoh permintaan curl -X POST \
-H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/json" \
-d '{"kind":"like","target":"5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1","active":true}' \
"https://api.tellmelo.com/v2/relations"Jawaban Menjawab dengan satu Ok
Contoh {
"ok": true
}Status yang mungkin: 200400401403429
GET /v2/profiles/{handle}/followersSiapa yang mengikuti sebuah profil, terbaru dulu.
Hak read berhalaman dengan ETag sejak v2.19 Parameter Nama Tipe Arti handledi path stringwajib Nama pendek sebuah profil, huruf besar atau kecil sama saja. limitdi query integeropsional Entri per halaman: 20 secara bawaan, maksimal 50. cursordi query stringopsional next dari jawaban sebelumnya. Tanpa itu, dari awal.
Contoh permintaan curl \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/profiles/mara/followers?limit=20"Jawaban Menjawab dengan satu halaman ProfileBrief
Contoh {
"items": [
{
"id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
"handle": "mara",
"name": "Mara 🌻",
"verified": true,
"accountKind": "person"
}
],
"next": "MTc1ODYyNDAwMDAwMDo1ZjBjMmE5ZS04ZDQx"
}Status yang mungkin: 200304400401404429
GET /v2/profiles/{handle}/followingSiapa yang diikuti sebuah profil, terbaru dulu.
Hak read berhalaman dengan ETag sejak v2.19 Parameter Nama Tipe Arti handledi path stringwajib Nama pendek sebuah profil, huruf besar atau kecil sama saja. limitdi query integeropsional Entri per halaman: 20 secara bawaan, maksimal 50. cursordi query stringopsional next dari jawaban sebelumnya. Tanpa itu, dari awal.
Contoh permintaan curl \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/profiles/mara/following?limit=20"Jawaban Menjawab dengan satu halaman ProfileBrief
Contoh {
"items": [
{
"id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
"handle": "mara",
"name": "Mara 🌻",
"verified": true,
"accountKind": "person"
}
],
"next": "MTc1ODYyNDAwMDAwMDo1ZjBjMmE5ZS04ZDQx"
}Status yang mungkin: 200304400401404429
GET /v2/me/relationsSiapa yang kamu blokir, bisukan, atau blokir hanya untuk pesan, terbaru dulu.
Hak read berhalaman dengan ETag sejak v2.19 Hanya daftarmu sendiri. Memasang dan menghapus lewat POST /relations.
Parameter Nama Tipe Arti kinddi query stringwajib block diblokir, mute dibisukan, dm_block diblokir hanya untuk pesan.blockmutedm_blocklimitdi query integeropsional Entri per halaman: 20 secara bawaan, maksimal 50. cursordi query stringopsional next dari jawaban sebelumnya. Tanpa itu, dari awal.
Contoh permintaan curl \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/me/relations?kind=mute&limit=20"Jawaban Menjawab dengan satu halaman ProfileBrief
Contoh {
"items": [
{
"id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
"handle": "mara",
"name": "Mara 🌻",
"verified": true,
"accountKind": "person"
}
],
"next": "MTc1ODYyNDAwMDAwMDo1ZjBjMmE5ZS04ZDQx"
}Status yang mungkin: 200304400401429
Koleksi Atur postingan tersimpan ke dalam koleksimu sendiri. Satu postingan bisa ada di beberapa koleksi; jika dikeluarkan dari koleksi, tetap tersimpan.
GET /v2/me/collectionsKoleksimu beserta jumlah postingannya.
Hak read dengan ETag sejak v2.19 Contoh permintaan curl \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/me/collections"Jawaban Menjawab dengan satu halaman Collection
Contoh {
"items": [
{
"id": "6d5c4b3a-2918-4e7f-a1b2-c3d4e5f60718",
"name": "Recipes",
"count": 12
}
],
"next": null
}Status yang mungkin: 200304401429
POST /v2/me/collectionsMembuat koleksi. Menjawab dengan id-nya.
Berapa banyak koleksi yang bisa kamu buat tergantung paketmu.
Parameter Nama Tipe Arti namedi isi stringwajib Namanya, paling banyak 40 karakter. Unik per akun, tanpa membedakan huruf besar-kecil.
Contoh permintaan curl -X POST \
-H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/json" \
-d '{"name":"Recipes"}' \
"https://api.tellmelo.com/v2/me/collections"Jawaban Menjawab dengan satu Made
Contoh {
"id": "0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a"
}Status yang mungkin: 200400401403429
PUT /v2/me/collections/{id}Mengganti nama koleksi.
Parameter Nama Tipe Arti iddi path stringwajib id koleksi.namedi isi stringwajib Namanya, paling banyak 40 karakter. Unik per akun, tanpa membedakan huruf besar-kecil.
Contoh permintaan curl -X PUT \
-H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/json" \
-d '{"name":"Baking"}' \
"https://api.tellmelo.com/v2/me/collections/6d5c4b3a-2918-4e7f-a1b2-c3d4e5f60718"Jawaban Menjawab dengan satu Ok
Contoh {
"ok": true
}Status yang mungkin: 200400401403404429
DELETE /v2/me/collections/{id}Menghapus koleksi.
Postingan di dalamnya tetap tersimpan.
Parameter Nama Tipe Arti iddi path stringwajib id koleksi.
Contoh permintaan curl -X DELETE \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/me/collections/6d5c4b3a-2918-4e7f-a1b2-c3d4e5f60718"Jawaban Menjawab dengan satu Ok
Contoh {
"ok": true
}Status yang mungkin: 200400401403404429
GET /v2/me/collections/{id}/postsPostingan dalam sebuah koleksi, seperti di tab tersimpan.
Hak read berhalaman sejak v2.19 Parameter Nama Tipe Arti iddi path stringwajib id koleksi.limitdi query integeropsional Entri per halaman: 20 secara bawaan, maksimal 50. cursordi query stringopsional next dari jawaban sebelumnya. Tanpa itu, dari awal.
Contoh permintaan curl \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/me/collections/6d5c4b3a-2918-4e7f-a1b2-c3d4e5f60718/posts?limit=20"Jawaban Menjawab dengan satu halaman Post
Contoh {
"items": [
{
"id": "5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1",
"text": "The bees are back in the garden 🐝 #garden",
"kind": "poll",
"author": {
"id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
"handle": "mara",
"name": "Mara 🌻",
"verified": true,
"accountKind": "person"
},
"community": {
"id": "c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60",
"name": "Urban Gardening"
},
"media": [
{
"url": "/api/media?id=b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918",
"kind": "image",
"poster": null,
"ai": "without"
}
],
"poll": {
"options": [
{
"text": "Lavender",
"votes": 12
},
{
"text": "Sunflowers",
"votes": 7
},
{
"text": "Clover",
"votes": 3
}
],
"total": 22,
"multiple": false,
"endsAt": null,
"running": true,
"resultsVisible": true,
"myVotes": [
0
]
},
"quotes": null,
"continues": null,
"counts": {
"replies": 4,
"likes": 31,
"reposts": 2
},
"pinned": false,
"giftDrop": {
"item": "plan",
"quantity": 3,
"places": 10,
"left": 4,
"audience": "followers",
"newAccounts": false,
"status": "open",
"claimed": true
},
"createdAt": 1758624000000
}
],
"next": "MTc1ODYyNDAwMDAwMDo1ZjBjMmE5ZS04ZDQx"
}Status yang mungkin: 200400401404429
POST /v2/me/collections/{id}/postsMemasukkan postingan ke koleksi atau mengeluarkannya.
Memasukkan postingan sekaligus menyimpannya. Hanya postingan yang terlihat.
Parameter Nama Tipe Arti iddi path stringwajib id koleksi.postdi isi stringwajib id postingan.insidedi isi booleanopsional true memasukkan postingan (bawaan), false mengeluarkannya.
Contoh permintaan curl -X POST \
-H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/json" \
-d '{"post":"5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1","inside":true}' \
"https://api.tellmelo.com/v2/me/collections/6d5c4b3a-2918-4e7f-a1b2-c3d4e5f60718/posts"Jawaban Menjawab dengan satu Ok
Contoh {
"ok": true
}Status yang mungkin: 200400401403404429
Hadiah Melihat kuota mitra dan memberi hadiah darinya, menaruh hadiah di postingan dan memantaunya. Mengambil hadiah tetap hanya untuk orang, di aplikasi.
GET /v2/partner/quotaSisa kuotamu untuk diberikan.
Hak read dengan ETag sejak v2.12 Hanya untuk mitra yang punya kuota; yang lain mendapat 403.
Contoh permintaan curl \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/partner/quota"Jawaban Menjawab dengan satu Quota
Contoh {
"months": 120,
"sparks": 500,
"looks": [
{
"id": "frame-gold",
"name": "Goldring",
"kind": "frame",
"quantity": 25
}
]
}Status yang mungkin: 200304401429
GET /v2/partner/giftsApa yang kamu berikan dari kuota, kepada siapa dan kapan – yang terbaru dulu.
Hak read berhalaman dengan ETag sejak v2.12 Hanya untuk mitra yang punya kuota; yang lain mendapat 403.
Parameter Nama Tipe Arti limitdi query integeropsional Entri per halaman: 20 secara bawaan, maksimal 50. cursordi query stringopsional next dari jawaban sebelumnya. Tanpa itu, dari awal.
Contoh permintaan curl \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/partner/gifts?limit=20"Jawaban Menjawab dengan satu halaman QuotaGift
Contoh {
"items": [
{
"item": "plan",
"quantity": 3,
"itemId": null,
"recipient": {
"handle": "jon",
"name": "Jon"
},
"createdAt": 1758627600000
}
],
"next": "MTc1ODYyNDAwMDAwMDo1ZjBjMmE5ZS04ZDQx"
}Status yang mungkin: 200304401429
POST /v2/partner/giftsMemberi bulan paket atau percikan dari kuotamu kepada anggota.
Hanya untuk mitra yang punya kuota; yang lain mendapat 403.
Seperti di aplikasi, anggota melihat dari siapa hadiahnya. Paling banyak 60 hadiah per jam.
Parameter Nama Tipe Arti handledi isi stringwajib @nama anggota yang kamu beri hadiah, dengan atau tanpa @. itemdi isi stringwajib plan untuk bulan paket, sparks untuk percikan, shop untuk tampilan dari stokmu (sejak 2.13).plansparksshopquantitydi isi integeropsional Berapa banyak: hingga 12 bulan atau 35 percikan per hadiah. itemIddi isi stringopsional Untuk shop: ID tampilan seperti yang disebut looks di kuota. Satu unit per hadiah; quantity tidak berlaku.
Contoh permintaan curl -X POST \
-H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/json" \
-d '{"handle":"jon","item":"plan","quantity":3,"itemId":"frame-gold"}' \
"https://api.tellmelo.com/v2/partner/gifts"Jawaban Menjawab dengan satu Quota
Contoh {
"months": 120,
"sparks": 500,
"looks": [
{
"id": "frame-gold",
"name": "Goldring",
"kind": "frame",
"quantity": 25
}
]
}Status yang mungkin: 200400401403429
GET /v2/gift-dropsHadiahmu di postingan: berapa tempat yang masih kosong dan bagaimana dibayar.
Hak read berhalaman dengan ETag sejak v2.12 Parameter Nama Tipe Arti limitdi query integeropsional Entri per halaman: 20 secara bawaan, maksimal 50. cursordi query stringopsional next dari jawaban sebelumnya. Tanpa itu, dari awal.
Contoh permintaan curl \
-H "Authorization: Bearer tm_key_…" \
"https://api.tellmelo.com/v2/gift-drops?limit=20"Jawaban Menjawab dengan satu halaman OwnGiftDrop
Contoh {
"items": [
{
"item": "plan",
"quantity": 3,
"places": 10,
"left": 4,
"audience": "followers",
"newAccounts": false,
"status": "open",
"claimed": false,
"postId": "5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1",
"funding": "quota",
"createdAt": 1758624000000
}
],
"next": "MTc1ODYyNDAwMDAwMDo1ZjBjMmE5ZS04ZDQx"
}Status yang mungkin: 200304401429
POST /v2/gift-dropsMemposting postingan berisi hadiah untuk diambil orang lain.
Gratis untuk pemilik dan anggota tim yang punya izin itu, selain itu dari kuotamu. Yang perlu dibayar ditolak dengan 422 – membayar hanya bisa di aplikasi.
Mengambil hadiah hanya bisa di aplikasi, supaya tidak ada program yang menyapu semua tempat. Sisa tempat ada di giftDrop postingan.
Parameter Nama Tipe Arti textdi isi stringopsional Teks postingan, balasan, atau pesan. communitydi isi stringopsional id grup yang kanal feed-nya menerima postingan; kanal itu harus menyala dan kamu perlu haknya. Tanpa itu, postingan berada di luar grup mana pun.itemdi isi stringwajib plan untuk bulan paket, sparks untuk percikan.plansparksquantitydi isi integerwajib Isi setiap tempat: hingga 12 bulan atau 35 percikan. placesdi isi integerwajib Untuk berapa orang, hingga 10.000. audiencedi isi stringopsional Siapa yang boleh mengambil: all semua, followers hanya pengikutmu, group hanya anggota grup (hanya bersama community).allfollowersgroup newAccountsdi isi booleanopsional true membolehkan akun yang berumur kurang dari 7 hari ikut mengambil. Tanpa ini, mereka tidak ikut.
Contoh permintaan curl -X POST \
-H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/json" \
-d '{"text":"Ten times three months of Supporter – first come, first served! 🎁","item":"plan","quantity":3,"places":10,"audience":"all","newAccounts":false}' \
"https://api.tellmelo.com/v2/gift-drops"Jawaban Menjawab dengan satu DropCreated
Contoh {
"id": "5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1",
"funding": "quota"
}Status yang mungkin: 200400401403429
Objek Semua objek, field demi field. [] berarti daftar.
ServiceJawaban root: siapa yang menjawab, dan apa yang boleh dilakukan kunci ini.
Field Tipe Arti namestringSelalu tellmelo. versionstringVersi API, misalnya 2.1. scopestringApa yang boleh dilakukan kunci ini: read atau read write. rateLimitRateLimitJatah kunci ini. docsstringDi mana dokumentasi ini, sebagai path di instans ini. specstringDi mana deskripsi yang bisa dibaca mesin.
Contoh {
"name": "tellmelo",
"version": "2.20",
"scope": "read write",
"rateLimit": {
"limit": 120,
"remaining": 117
},
"docs": "/developers/docs",
"spec": "/api/v2/openapi.json"
}RateLimitJatah kunci ini di menit ini.
Field Tipe Arti limitintegerPermintaan per menit. remainingintegerBerapa yang tersisa di menit ini.
Contoh {
"limit": 120,
"remaining": 117
}PostSebuah postingan, dengan bentuk yang sama di mana-mana.
Field Tipe Arti idstringid postingan. textstringatau null Teks seperti ditulis (null untuk postingan yang hanya jajak pendapat atau hanya gambar). kindstringApa postingan ini.post — Postingan dengan teks, gambar, atau kutipan.poll — Postingan dengan jajak pendapat. authorProfileBriefSiapa yang menulisnya. communityCommunityBriefatau null Grup tempat ditulis (null di luar semua grup). mediaMedia[]Gambarnya, berurutan; kosong jika tidak ada. pollPollatau null Jajak pendapat (null jika tidak ada). quotesstringatau null id postingan yang dikutip postingan ini. continuesstringatau null id postingan yang dilanjutkan postingan ini, sebagai tambahan. countsCountsBalasan, suka, dan posting ulang. pinnedbooleanApakah disematkan di atas profil penulisnya. giftDropGiftDropatau null Hadiah yang bisa diambil di postingan (null jika tidak ada). createdAtintegerKapan ditulis.
Contoh {
"id": "5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1",
"text": "The bees are back in the garden 🐝 #garden",
"kind": "poll",
"author": {
"id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
"handle": "mara",
"name": "Mara 🌻",
"verified": true,
"accountKind": "person"
},
"community": {
"id": "c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60",
"name": "Urban Gardening"
},
"media": [
{
"url": "/api/media?id=b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918",
"kind": "image",
"poster": null,
"ai": "without"
}
],
"poll": {
"options": [
{
"text": "Lavender",
"votes": 12
},
{
"text": "Sunflowers",
"votes": 7
},
{
"text": "Clover",
"votes": 3
}
],
"total": 22,
"multiple": false,
"endsAt": null,
"running": true,
"resultsVisible": true,
"myVotes": [
0
]
},
"quotes": null,
"continues": null,
"counts": {
"replies": 4,
"likes": 31,
"reposts": 2
},
"pinned": false,
"giftDrop": {
"item": "plan",
"quantity": 3,
"places": 10,
"left": 4,
"audience": "followers",
"newAccounts": false,
"status": "open",
"claimed": true
},
"createdAt": 1758624000000
}ReplyBalasan di bawah postingan: postingan dengan dua field tambahan.
Semua field dari Post
Field Tipe Arti postIdstringPostingan tempat seluruh percakapan bergantung. parentIdstringatau null Balasan yang dijawab balasan ini (null jika langsung menjawab postingan).
Contoh {
"id": "9e4b1c7d-2a3f-4d5e-8b6c-0f1e2d3c4b5a",
"text": "Same here, the lavender is full of them.",
"kind": "post",
"author": {
"id": "d4c3b2a1-6e5f-4a7b-9c8d-1e2f3a4b5c6d",
"handle": "jon",
"name": "Jon",
"verified": false,
"accountKind": "person"
},
"community": null,
"media": [],
"poll": null,
"quotes": null,
"continues": null,
"counts": {
"replies": 0,
"likes": 3,
"reposts": 0
},
"pinned": false,
"giftDrop": null,
"createdAt": 1758624600000,
"postId": "5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1",
"parentId": null
}ReplyVoteSuaramu pada sebuah balasan dan skornya.
Field Tipe Arti votestringSuaramu.up — Naik.down — Turun.none — Tanpa suara. scoreintegerSuara naik dikurangi suara turun, bisa di bawah nol.
Contoh {
"vote": "up",
"score": 12
}PlannedReplyBalasanmu yang dijadwalkan untuk nanti.
Field Tipe Arti idstringid balasan terjadwal.parentIdstringatau null Balasan yang akan dijawabnya (null jika langsung ke postingan). textstringTeksnya. publishAtintegerKapan terbit. statestringStatusnya.waiting — Menunggu waktunya.failed — Tidak bisa dikirim, misalnya karena postingannya sudah tidak ada.
Contoh {
"id": "3b2a1c0d-9e8f-4a7b-b6c5-d4e3f2a1b0c9",
"parentId": null,
"text": "Count me in for Saturday!",
"publishAt": 1758710400000,
"state": "waiting"
}ReplySettingsPengaturan balasan salah satu postinganmu.
Field Tipe Arti audiencestringSiapa yang boleh membalas.all — Semua.following — Akun yang kamu ikuti.mentioned — Yang disebut di postingan.nobody — Tidak ada selain kamu. approvalbooleanApakah balasan menunggu persetujuanmu. slowstringMode lambat.auto — Menyala sendiri saat banyak balasan masuk.on — Selalu aktif.off — Mati.
Contoh {
"audience": "following",
"approval": false,
"slow": "auto"
}CountsBerapa balasan, suka, dan posting ulang yang dimiliki postingan.
Field Tipe Arti repliesintegerBalasan, semua tingkat bersama. likesintegerSuka. repostsintegerPosting ulang.
Contoh {
"replies": 4,
"likes": 31,
"reposts": 2
}PollJajak pendapat dari postingan.
Field Tipe Arti optionsPollOption[]Jawaban-jawabannya, berurutan. option dalam pemungutan suara dihitung dari 0. totalintegerSemua suara bersama, selalu ada. multiplebooleanApakah boleh memilih lebih dari satu jawaban. endsAtintegeratau null Kapan jajak pendapat berakhir (null jika berjalan tanpa akhir). runningbooleanApakah masih bisa memilih. resultsVisiblebooleanApakah suara per jawaban ditampilkan (lihat votes). myVotesinteger[]Jawaban yang kamu pilih, dihitung dari 0.
Contoh {
"options": [
{
"text": "Lavender",
"votes": 12
},
{
"text": "Sunflowers",
"votes": 7
},
{
"text": "Clover",
"votes": 3
}
],
"total": 22,
"multiple": false,
"endsAt": null,
"running": true,
"resultsVisible": true,
"myVotes": [
0
]
}PollOptionSatu jawaban dari jajak pendapat.
Field Tipe Arti textstringJawabannya. votesintegeratau null Suaranya (null selama hasil ditahan).
Contoh {
"text": "Lavender",
"votes": 12
}ProfileBriefProfil seperti yang muncul di dalam objek lain: sebagai penulis, dalam pencarian.
Field Tipe Arti idstringid akun: yang diharapkan /relations dan /conversations/{with}. handlestringNama pendek, tanpa @, ditulis seperti yang dipilih anggota. namestringNama tampilan. Bisa memuat emoji, termasuk :name:. verifiedbooleanApakah akun terverifikasi. accountKindstringJenis akun apa.person — Seseorang.business — Sebuah usaha.association — Klub atau perkumpulan.automated — Akun otomatis, seperti bot.bot — Bot grup yang dijalankan program dengan kuncinya sendiri (sejak 2.18).
Contoh {
"id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
"handle": "mara",
"name": "Mara 🌻",
"verified": true,
"accountKind": "person"
}ProfileProfil tersendiri, dengan deskripsi dan pengikutnya.
Semua field dari ProfileBrief
Field Tipe Arti aboutstringatau null Deskripsi (null jika tidak ada). websitestringatau null Situs web profil (null jika tidak ada). Sejak 2.3. websiteVerifiedbooleanApakah situs web menautkan balik ke profil ini dengan rel=me, diperiksa setiap minggu. Sejak 2.3. followersintegerBerapa akun yang mengikutinya. createdAtintegeratau null Kapan akun dibuat (null selama anggota menyembunyikan tanggal bergabung; sejak 2.9).
Contoh {
"id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
"handle": "mara",
"name": "Mara 🌻",
"verified": true,
"accountKind": "person",
"about": "Beekeeper, allotment, too many seeds. :tellmelo:",
"website": "https://mara-imkerei.example/",
"websiteVerified": true,
"followers": 148,
"createdAt": 1750848000000
}MembershipApa posisi akunmu di grup dan apa yang boleh dilakukannya.
Field Tipe Arti leaderstringatau null Apakah kamu pendiri grup atau ikut memimpinnya; null jika tidak.founder — Pendiri.manager — Wakil pengurus. rolesstring[]id peranmu, yang tertinggi dulu.permissionsstring[]Apa yang boleh kamu lakukan di grup. mutedUntilintegeratau null Sampai kapan pembisuan membisukanmu di sini; null jika tidak ada.
Contoh {
"leader": null,
"roles": [
"4e5f6a7b-8c9d-4e0f-a1b2-c3d4e5f6a7b8"
],
"permissions": [
"attach",
"invite",
"send",
"view"
],
"mutedUntil": null
}PersonSeorang anggota, singkat.
Field Tipe Arti idstringid akun.handlestringNama pengguna, tanpa @. namestringNama tampilan. botbooleanApakah akun ini bot (sejak 2.18).
Contoh {
"id": "d4c3b2a1-6e5f-4a7b-9c8d-1e2f3a4b5c6d",
"handle": "jon",
"name": "Jon",
"bot": false
}ChannelSebuah kanal grup.
Field Tipe Arti idstringid.kindstringJenis kanal.feed — Kanal feed, yang postingannya juga ada di feed publik.chat — Sebuah obrolan.voice — Kanal suara; berbicara hanya di aplikasi.hub — Hub grup: halaman yang memperkenalkan grup. Selalu ada, tanpa pesan. namestringatau null Nama tanpa #; null untuk nama yang diberikan aplikasi dalam tiap bahasa. topicstringTopik; kosong jika tidak ada. categoryChannelCategoryatau null Kategori; null jika tanpa kategori. unreadintegerBerapa pesan orang lain yang belum kamu baca, hingga 100. permissionsstring[]Apa yang boleh kamu lakukan di kanal ini. symbolChannelSymbolSimbolnya; bentuknya sudah milik grup jika grup menetapkannya.
Contoh {
"id": "0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a",
"kind": "chat",
"name": "harvest",
"topic": "What came in this week",
"category": {
"id": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",
"name": "Garden",
"symbol": {
"emoji": null,
"icon": null,
"image": null,
"color": null,
"shape": null
}
},
"unread": 3,
"permissions": [
"view",
"send"
],
"symbol": {
"emoji": "🌻",
"icon": null,
"image": null,
"color": "amber",
"shape": "circle"
}
}ChannelCategoryKategori tempat sebuah kanal berada.
Field Tipe Arti idstringid.namestringNama. symbolChannelSymbolSimbolnya.
Contoh {
"id": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",
"name": "Garden",
"symbol": {
"emoji": null,
"icon": null,
"image": null,
"color": null,
"shape": null
}
}ChannelSymbolSimbol kanal atau kategori: paling banyak satu dari emoji, simbol dan gambar, jika tidak tanda jenisnya.
Field Tipe Arti emojistringatau null Emoji; null jika tidak ada. iconstringatau null Nama simbol dari set aplikasi; null jika tidak ada. imagestringatau null Alamat gambar sendiri; null jika tidak ada. colorstringatau null Warna petak; null untuk warna jenisnya. shapestringatau null Bentuk petak; null untuk lingkaran.
Contoh {
"emoji": "🌻",
"icon": null,
"image": null,
"color": "amber",
"shape": "circle"
}ChannelMessageSebuah pesan di kanal obrolan.
Field Tipe Arti idstringid.textstringatau null Teks (null untuk pesan yang hanya berisi gambar atau suara). authorPersonSiapa yang menulisnya. mediaMedia[]Gambar dan pesan suaranya; kosong jika tidak ada. replyTostringatau null id pesan yang dibalasnya; null jika tidak ada.roleColorstringatau null Warna peran tertinggi penulis yang punya warna; null jika tidak ada. threadOfstringatau null Pesan yang utasnya dibalas oleh pesan ini; null di obrolan. threadCountintegerBerapa balasan di utas pesan ini. cardobjectatau null Kartu bot: title, text, color, dan fields; selain itu null. buttonsobject[]Tombol bot: masing-masing id, label, dan style. createdAtintegerKapan ditulis.
Contoh {
"id": "61a2b3c4-d5e6-4f70-8192-a3b4c5d6e7f8",
"text": "@jon the first tomatoes are ripe 🍅",
"author": {
"id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
"handle": "mara",
"name": "Mara 🌻",
"bot": false
},
"media": [
{
"url": "/api/media?id=b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918",
"kind": "image",
"poster": null,
"ai": "without"
}
],
"replyTo": "72b3c4d5-e6f7-4081-92a3-b4c5d6e7f809",
"roleColor": "green",
"threadOf": null,
"threadCount": 3,
"card": null,
"buttons": [],
"createdAt": 1758631200000
}RoleSebuah peran grup.
Field Tipe Arti idstringid.namestringatau null Nama; null untuk @everyone. everyonebooleanApakah ini @everyone, peran semua anggota. colorstringatau null Warna: indigo, violet, rose, amber, green, atau teal; null tanpa warna. permissionsstring[]Haknya. membersintegerBerapa orang yang memilikinya; untuk @everyone semua anggota. editablebooleanApakah akunmu boleh mengubahnya. selfablebooleanApakah anggota mengambil dan melepas peran itu sendiri.
Contoh {
"id": "4e5f6a7b-8c9d-4e0f-a1b2-c3d4e5f6a7b8",
"name": "Gardeners",
"everyone": false,
"color": "green",
"permissions": [
"attach",
"invite",
"send",
"view"
],
"members": 24,
"editable": true,
"selfable": false
}GroupMemberAnggota grup beserta perannya.
Semua field dari Person
Field Tipe Arti leaderstringatau null Apakah anggota ini pendiri grup atau ikut memimpinnya; null jika tidak.founder — Pendiri.manager — Wakil pengurus. rolesstring[]id perannya, yang tertinggi dulu.mutedUntilintegeratau null Sampai kapan anggota dibisukan, jika akunmu boleh membisukan; selain itu null.
Contoh {
"id": "d4c3b2a1-6e5f-4a7b-9c8d-1e2f3a4b5c6d",
"handle": "jon",
"name": "Jon",
"bot": false,
"leader": null,
"roles": [
"4e5f6a7b-8c9d-4e0f-a1b2-c3d4e5f6a7b8"
],
"mutedUntil": null
}ChannelOverrideApa yang boleh dilakukan peran secara berbeda di sebuah kanal dibanding di grup.
Field Tipe Arti rolestringid peran.allowstring[]Apa yang boleh dilakukannya di sini sebagai tambahan. denystring[]Apa yang tidak boleh dilakukannya di sini.
Contoh {
"role": "4e5f6a7b-8c9d-4e0f-a1b2-c3d4e5f6a7b8",
"allow": [
"send"
],
"deny": []
}BellLonceng sebuah grup.
Field Tipe Arti levelstringNotifikasi apa yang datang.all — Setiap postingan baru di kanal feed, ditambah @everyone.important — Postingan pengurus di kanal feed, ditambah @everyone.off — Tidak ada, kecuali kamu disebut dengan @nama.
Contoh {
"level": "important"
}InviteLinkTautan undangan sebuah grup.
Field Tipe Arti codestringKode. urlstringAlamat untuk dibagikan. createdByPersonatau null Siapa yang membuatnya; null jika akunnya dihapus. createdAtintegerKapan dibuat. expiresAtintegeratau null Sampai kapan berlaku; null tanpa akhir. usesintegerBerapa kali sudah dipakai. maxUsesintegeratau null Berapa kali bisa dipakai; null tanpa batas.
Contoh {
"code": "k7Qm2xPa",
"url": "https://tellmelo.com/groups?join=k7Qm2xPa",
"createdBy": {
"id": "d4c3b2a1-6e5f-4a7b-9c8d-1e2f3a4b5c6d",
"handle": "jon",
"name": "Jon",
"bot": false
},
"createdAt": 1758624000000,
"expiresAt": 1759228800000,
"uses": 3,
"maxUses": 10
}InvitePreviewKe mana tautan undangan mengarah.
Field Tipe Arti communityInviteGroupGrupnya. memberbooleanApakah akunmu sudah menjadi anggota.
Contoh {
"community": {
"id": "c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60",
"name": "Urban Gardening",
"members": 312,
"rules": [
"Be kind.",
"No advertising."
]
},
"member": false
}InviteGroupGrup di balik tautan undangan.
Field Tipe Arti idstringid.namestringNama. membersintegerBerapa anggotanya. rulesstring[]Aturannya, yang diterima saat bergabung; kosong jika tidak ada.
Contoh {
"id": "c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60",
"name": "Urban Gardening",
"members": 312,
"rules": [
"Be kind.",
"No advertising."
]
}JoinedBergabung dengan tautan undangan.
Field Tipe Arti communitystringid grup.
Contoh {
"community": "c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60"
}LogEntrySatu entri di log pengurus.
Field Tipe Arti idstringid.actionstringApa yang terjadi.post_removed — Sebuah postingan.member_removed — Anggota dikeluarkan, sebelum 2.16 (di luar selama 90 hari).message_removed — Sebuah pesan di kanal obrolan.member_kicked — Pengeluaran.member_banned — Blokir.member_unbanned — Blokir yang dicabut.member_timed_out — Pembisuan.timeout_lifted — Pembisuan yang dicabut.voice_muted — Dibisukan di kanal suara.voice_removed — Diputus dari kanal suara.bot_added — Sebuah bot masuk ke grup (sejak 2.18).bot_removed — Sebuah bot dikeluarkan dari grup (sejak 2.18). memberPersonSiapa yang terkena. reasonstringAlasannya; kosong untuk pesan dan jika tidak diberikan. bystringatau null Nama yang melakukannya; null jika akunnya dihapus. createdAtintegerKapan.
Contoh {
"id": "8f7e6d5c-4b3a-4291-8f7e-6d5c4b3a2918",
"action": "message_removed",
"member": {
"id": "d4c3b2a1-6e5f-4a7b-9c8d-1e2f3a4b5c6d",
"handle": "jon",
"name": "Jon",
"bot": false
},
"reason": "",
"by": "Mara 🌻",
"createdAt": 1758710400000
}BanBlokir dari sebuah grup.
Field Tipe Arti memberPersonSiapa yang diblokir. untilintegeratau null Sampai kapan; null sampai dicabut. createdAtintegeratau null Sejak kapan; null untuk blokir sebelum 2.16. bystringatau null Nama yang memblokir; null jika tidak diketahui.
Contoh {
"member": {
"id": "d4c3b2a1-6e5f-4a7b-9c8d-1e2f3a4b5c6d",
"handle": "jon",
"name": "Jon",
"bot": false
},
"until": 1759228800000,
"createdAt": 1758624000000,
"by": "Mara 🌻"
}UntilKapan pembisuan atau blokir berakhir.
Field Tipe Arti untilintegeratau null Waktunya; null untuk blokir tanpa akhir atau pembisuan yang dicabut.
Contoh {
"until": 1758624600000
}TagTag dan berapa postingan yang memakainya.
Field Tipe Arti tagstringTag, tanpa #. postsintegerBerapa postingan terbaru yang memakainya.
Contoh {
"tag": "garden",
"posts": 58
}SearchResultTiga daftar, mungkin kosong.
Field Tipe Arti postsPost[]Postingan yang cocok, terbaru lebih dulu. profilesProfileBrief[]Profil yang cocok, menurut nama pendek. tagsTag[]Tag yang cocok, yang paling sering dipakai lebih dulu.
Contoh {
"posts": [
{
"id": "5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1",
"text": "The bees are back in the garden 🐝 #garden",
"kind": "poll",
"author": {
"id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
"handle": "mara",
"name": "Mara 🌻",
"verified": true,
"accountKind": "person"
},
"community": {
"id": "c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60",
"name": "Urban Gardening"
},
"media": [
{
"url": "/api/media?id=b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918",
"kind": "image",
"poster": null,
"ai": "without"
}
],
"poll": {
"options": [
{
"text": "Lavender",
"votes": 12
},
{
"text": "Sunflowers",
"votes": 7
},
{
"text": "Clover",
"votes": 3
}
],
"total": 22,
"multiple": false,
"endsAt": null,
"running": true,
"resultsVisible": true,
"myVotes": [
0
]
},
"quotes": null,
"continues": null,
"counts": {
"replies": 4,
"likes": 31,
"reposts": 2
},
"pinned": false,
"giftDrop": {
"item": "plan",
"quantity": 3,
"places": 10,
"left": 4,
"audience": "followers",
"newAccounts": false,
"status": "open",
"claimed": true
},
"createdAt": 1758624000000
}
],
"profiles": [
{
"id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
"handle": "mara",
"name": "Mara 🌻",
"verified": true,
"accountKind": "person"
}
],
"tags": [
{
"tag": "garden",
"posts": 58
}
]
}EmojiEmoji di instans ini.
Field Tipe Arti namestringNamanya, seperti tertulis di antara titik dua. urlstringAlamat gambar, relatif terhadap instans ini.
Contoh {
"name": "tellmelo",
"url": "/api/media?id=e1f2a3b4-c5d6-4e7f-8a9b-0c1d2e3f4a5b"
}NotificationNotifikasi. Satu baris bisa menghimpun beberapa peristiwa sejenis.
Field Tipe Arti idstringid notifikasi. kindstringApa yang terjadi.reply — Seseorang membalasmu.like — Seseorang menyukai postinganmu.reply_like — Seseorang memberi suara naik untuk balasanmu.duel — Seseorang menantangmu di Duel Feed, atau tantanganmu sudah dimainkan.reply_pick — Penulis kiriman menyorot balasanmu.repost — Seseorang memposting ulang postinganmu.follow — Seseorang mengikutimu.mention — Seseorang menyebutmu.group_mention — Seseorang menyebut grup yang kamu pimpin; text adalah namanya.channel_mention — Seseorang menyebutmu di kanal obrolan salah satu grupmu, termasuk dengan @everyone; anggota itu adalah actor, kalimatnya menyebut kanal dan grup, tidak pernah pesannya.message — Seseorang mengirimimu pesan.scheduled — Postingan terjadwalmu sudah diterbitkan.video — Postinganmu yang menunggu videonya sudah terbit atau kembali menjadi draf.reminder — Pengingat tentang postingan tersimpan sudah waktunya.report — Apa yang terjadi dengan laporan yang kamu kirim.moderation — Keputusan tentang akunmu: peringatan, pembatasan, banding.team — Pekerjaan baru untuk tim (hanya pemilik, admin, dan moderator).reward — Hadiah untuk mengundang akan berakhir atau sudah berakhir.gift — Hadiah dari tim: sebuah paket, atau percikan untukmu atau untuk grup yang kamu pimpin.present — Hadiah dari seorang anggota: percikan atau waktu paket; anggota itu adalah actor.spark — Percikan segera habis, atau grup yang kamu pimpin tidak lagi punya cukup percikan untuk keuntungannya.loyalty — Tentang ritme kesetiaan: minggu aktif terhitung atau kurang satu hari, hadiah baru atau akan memudar.impact — Bagaimana postinganmu selama dua belas jam diterima setelah sehari, dalam satu notifikasi.discovery — Undangan ke program Ditemukan, atau bahwa sebuah tempat di sana dimulai atau berakhir.group_post — Postingan baru di grup yang loncengnya berbunyi untuk itu.group_moderation — Pimpinan grup menghapus salah satu postinganmu, atau mengeluarkanmu dari grup.group — Sesuatu yang dilakukan seorang anggota terhadapmu di sebuah grup: mengundang, menerima atau menolak, menjadikanmu wakil administrator, menyerahkan atau membubarkan grup, atau mendaftar ke grupmu; anggota itu adalah actor, nama grup ada di akhir kalimat.coauthor — Seseorang mengundangmu sebagai rekan penulis postingan.partner — Pengingat dari program mitra, atau berakhirnya lencana mitra.news — Artikel baru di daerah yang kamu ikuti.pick — Postinganmu masuk nominasi postingan minggu ini atau tahun ini, atau sudah menang.advent — Pintu baru Kalender Adven terbuka, satu pintu dibuka, atau pintu hari ini masih menunggu.team_message — Pesan yang ditulis tim tellmelo untuk anggota terpilih.challenge — Tantangan minggu ini yang baru sudah dimulai.nudge — Sekali saja: postingan yang belum dibalas siapa pun, atau tantangan yang sedang berjalan.signin — Sebuah komputer bertanya apakah kamu sedang masuk di sana. textstringatau null Hanya untuk laporan dan moderasi: teks terkait, selain itu null. actorActorSiapa yang melakukannya. postIdstringatau null Postingan yang dimaksud (null jika tidak ada). readbooleanApakah sudah ditandai dibaca. moreintegerBerapa peristiwa lain yang diwakili baris ini, selain yang disebut. createdAtintegerKapan pertama kali terjadi. updatedAtintegerKapan terakhir kali menghimpun peristiwa lain. Daftar diurutkan menurut ini.
Contoh {
"id": "3f2e1d0c-9b8a-4765-8432-10fedcba9876",
"kind": "like",
"text": null,
"actor": {
"handle": "jon",
"name": "Jon"
},
"postId": "5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1",
"read": false,
"more": 2,
"createdAt": 1758624300000,
"updatedAt": 1758624900000
}ActorSiapa yang memicu notifikasi.
Field Tipe Arti handlestringNama pendek. namestringNama tampilan.
Contoh {
"handle": "jon",
"name": "Jon"
}ConversationSatu baris kotak masukmu.
Field Tipe Arti withstringid akun lainnya: yang diharapkan /conversations/{with}/messages. handlestringNama pendeknya. namestringNama tampilannya. excerptstringatau null Awal pesan terakhir (null jika tidak ada teks). truncatedbooleanApakah kutipannya dipotong. fromMebooleanApakah pesan terakhir milikmu. lastMessageIdstringid pesan terakhir. unreadintegerBerapa pesannya yang belum kamu baca. updatedAtintegerKapan pesan terakhir ditulis.
Contoh {
"with": "d4c3b2a1-6e5f-4a7b-9c8d-1e2f3a4b5c6d",
"handle": "jon",
"name": "Jon",
"excerpt": "See you on Saturday at the market!",
"truncated": false,
"fromMe": true,
"lastMessageId": "7c6b5a49-3827-4165-9f0e-d1c2b3a49586",
"unread": 0,
"updatedAt": 1758624060000
}MessagePesan dalam percakapan.
Field Tipe Arti idstringid pesan. textstringatau null Teksnya (null untuk pesan yang hanya gambar). fromstringid akun yang menulisnya. tostringid akun yang dituju. readbooleanApakah penerima sudah membacanya. mediaMedia[]Gambarnya; kosong jika tidak ada. replyTostringatau null id pesan yang dijawab pesan ini (null jika tidak menjawab apa pun). Sejak 2.2.createdAtintegerKapan dikirim.
Contoh {
"id": "7c6b5a49-3827-4165-9f0e-d1c2b3a49586",
"text": "See you on Saturday at the market!",
"from": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
"to": "d4c3b2a1-6e5f-4a7b-9c8d-1e2f3a4b5c6d",
"read": true,
"media": [],
"replyTo": null,
"createdAt": 1758624060000
}PlannedMessagePesanmu yang dijadwalkan untuk nanti.
Field Tipe Arti idstringid pesan terjadwal.tostringid akun penerimanya.textstringatau null Teksnya, null dengan enkripsi ujung ke ujung. sendAtintegerKapan dikirim. statestringStatusnya.waiting — Menunggu waktunya.held — Ditahan karena paket berakhir. Kamu bisa mengirim atau menghapusnya sendiri.failed — Tidak bisa dikirim.
Contoh {
"id": "3b2a1c0d-9e8f-4a7b-b6c5-d4e3f2a1b0c9",
"to": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
"text": "Happy birthday! 🎂",
"sendAt": 1758710400000,
"state": "waiting"
}ScheduledPostSalah satu postinganmu yang belum tayang.
Field Tipe Arti idstringid postingan. textstringatau null Teks. communityIdstringatau null Grup tempat postingan tayang (null di luar grup). publishAtintegeratau null Kapan tayang (null selama menunggu hal lain). deleteAtintegeratau null Kapan terhapus sendiri (null: tidak pernah). waitingForstringApa yang ditunggunya.time — Waktunya.review — Persetujuan teks yang ditulis untuk ditinjau.check — Pemeriksaan moderasi otomatis.payment — Pembayaran hadiahnya. createdAtintegerKapan ditulis.
Contoh {
"id": "5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1",
"text": "Market day tomorrow – see you at the bee stand! #garden",
"communityId": null,
"publishAt": 1758710400000,
"deleteAt": null,
"waitingFor": "time",
"createdAt": 1758624000000
}CollectionKoleksi postingan tersimpan.
Field Tipe Arti idstringid koleksi.namestringNamanya. countintegerBerapa postingan di dalamnya.
Contoh {
"id": "6d5c4b3a-2918-4e7f-a1b2-c3d4e5f60718",
"name": "Recipes",
"count": 12
}EventAcara mendatang dari sebuah profil.
Field Tipe Arti idstringid acara.titlestringJudulnya. startsAtintegerMulai. endsAtintegeratau null Selesai, null tanpa waktu selesai. placestringatau null Tempatnya. descriptionstringatau null Deskripsinya. signupsEventSignupsatau null Pendaftaran, null tanpa pendaftaran.
Contoh {
"id": "2a3b4c5d-6e7f-4809-9a1b-2c3d4e5f6a7b",
"title": "Seed swap",
"startsAt": 1758883200000,
"endsAt": 1758890400000,
"place": "Community garden",
"description": "Bring seeds, take seeds.",
"signups": {
"count": 14,
"going": true
}
}EventSignupsBerapa orang yang mendaftar.
Field Tipe Arti countintegerJumlah pendaftar. goingbooleanApakah kamu terdaftar.
Contoh {
"count": 14,
"going": true
}EventSignupSeseorang yang mendaftar ke salah satu acaramu.
Field Tipe Arti idstringid akun.handlestringNama pengguna. namestringNama tampilan. atintegerKapan mendaftar.
Contoh {
"id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
"handle": "mara",
"name": "Mara 🌻",
"at": 1758624000000
}PictureGambar yang diunggah.
Field Tipe Arti idstringid gambar.urlstringDi mana gambar bisa dilihat.
Contoh {
"id": "8c7b6a59-4837-4261-9f5e-d4c3b2a1f0e9",
"url": "/api/media?id=8c7b6a59-4837-4261-9f5e-d4c3b2a1f0e9"
}EmojiPictureGambar emoji yang diunggah.
Field Tipe Arti idstringid gambar.urlstringDi mana gambar bisa dilihat. animatedbooleanApakah bergerak.
Contoh {
"id": "8c7b6a59-4837-4261-9f5e-d4c3b2a1f0e9",
"url": "/api/media?id=8c7b6a59-4837-4261-9f5e-d4c3b2a1f0e9",
"animated": false
}OwnEmojiSalah satu emoji milikmu.
Field Tipe Arti namestringNamanya. urlstringGambarnya. animatedbooleanApakah bergerak. restingbooleanSedang istirahat karena paket saat ini mengizinkan lebih sedikit emoji: tetap ada, tetapi tidak bisa dipakai.
Contoh {
"name": "sunflower",
"url": "/api/media?id=8c7b6a59-4837-4261-9f5e-d4c3b2a1f0e9",
"animated": false,
"resting": false
}GroupEmojiEmoji sebuah grup.
Field Tipe Arti namestringNamanya. urlstringGambarnya. animatedbooleanApakah bergerak.
Contoh {
"name": "seedling",
"url": "/api/media?id=8c7b6a59-4837-4261-9f5e-d4c3b2a1f0e9",
"animated": false
}BotEventPeristiwa di salah satu grup bot.
Field Tipe Arti idstringNomornya, menaik; dengan itu dilanjutkan (since, Last-Event-ID). typestringApa yang terjadi.message.created — Sebuah pesan ditulis.message.deleted — Sebuah pesan dihapus.member.joined — Seseorang bergabung.member.left — Seseorang keluar atau dikeluarkan.voice.joined — Seseorang masuk ke kanal suara.command — Seseorang memakai perintah bot.interaction — Seseorang menekan tombol di pesan bot. communitystringGrupnya. channelstringatau null Kanalnya; null untuk seluruh grup. createdAtintegerKapan terjadi. dataobjectYang terkait, menurut jenis: message, member (dengan reason), command, atau interaction.
Contoh {
"id": "4711",
"type": "message.created",
"community": "c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60",
"channel": "0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a",
"createdAt": 1758634800000,
"data": {
"message": {
"id": "61a2b3c4-d5e6-4f70-8192-a3b4c5d6e7f8",
"text": "/dice 6",
"author": {
"id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
"handle": "mara",
"name": "Mara 🌻",
"bot": false
},
"media": 0,
"replyTo": null,
"threadOf": null,
"createdAt": 1758634800000
}
}
}BotCommandPerintah sebuah bot.
Field Tipe Arti namestringNamanya, tanpa “/”. descriptionstringApa yang dilakukannya.
Contoh {
"name": "dice",
"description": "Rolls a die"
}VoiceSeatTempat di kanal suara.
Field Tipe Arti urlstringAlamat server media (LiveKit). tokenstringToken untuk kanal ini, berlaku beberapa menit. iceServersobject[]Server STUN dan TURN untuk koneksi. speakbooleanApakah bot boleh mengirim suara di sana. videobooleanApakah bot boleh mengirim video di sana.
Contoh {
"url": "wss://voice.example.org",
"token": "eyJhbGciOiJIUzI1NiJ9…",
"iceServers": [
{
"urls": [
"stun:turn.example.org:3478"
]
}
],
"speak": true,
"video": false
}WebhookSalah satu webhook-mu.
Field Tipe Arti idstringid webhook.urlstringAlamatnya. kindsstring[]Hal yang diberitahukan kepadanya. activebooleanApakah menerima pengiriman. Setelah banyak kegagalan berturut-turut, dimatikan. lastStatusintegeratau null Status HTTP pengiriman terakhir. lastAtintegeratau null Kapan pengiriman terakhir. failuresintegerKegagalan berturut-turut.
Contoh {
"id": "1f2e3d4c-5b6a-4798-8a7b-6c5d4e3f2a1b",
"url": "https://example.org/tellmelo-hook",
"kinds": [
"reply",
"mention"
],
"active": true,
"lastStatus": 200,
"lastAt": 1758624000000,
"failures": 0
}WebhookCreatedWebhook baru beserta rahasianya.
Field Tipe Arti idstringid webhook.secretstringRahasia untuk tanda tangan, hanya kali ini.
Contoh {
"id": "1f2e3d4c-5b6a-4798-8a7b-6c5d4e3f2a1b",
"secret": "whsec_3f9a…"
}GroupBotBot sebuah grup.
Field Tipe Arti idstringid akun bot.handlestringNama singkatnya. namestringNamanya. descriptionstringApa yang dilakukannya, menurut pemiliknya. permissionsstring[]Apa yang diizinkan perannya di grup.
Contoh {
"id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
"handle": "gardenbot",
"name": "Garden bot",
"description": "Reminds the group of watering days.",
"permissions": [
"send",
"view"
]
}VoiceRoomSaluran suara beserta orang di dalamnya.
Field Tipe Arti channelstringid saluran.peopleVoicePerson[]Siapa yang sedang ada di dalamnya.
Contoh {
"channel": "0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a",
"people": [
{
"id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
"handle": "mara",
"name": "Mara 🌻",
"muted": false,
"deaf": false,
"camera": false,
"screen": true
}
]
}VoicePersonSeseorang di saluran suara.
Field Tipe Arti idstringid akun.handlestringNama singkat. namestringNama tampilan. mutedbooleanApakah mikrofonnya mati. deafbooleanApakah ia tidak mendengar apa pun (pilihannya sendiri). camerabooleanApakah kameranya menyala. screenbooleanApakah ia berbagi layar.
Contoh {
"id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
"handle": "mara",
"name": "Mara 🌻",
"muted": true,
"deaf": false,
"camera": false,
"screen": false
}GiftDropHadiah di sebuah postingan – tanpa pernah menyebut nama yang mengambilnya.
Field Tipe Arti itemstringIsi satu tempat.plan — Bulan paket (Pendukung).sparks — Percikan. quantityintegerBerapa isi setiap tempat: bulan atau percikan. placesintegerJumlah seluruh tempat. leftintegerBerapa yang masih kosong. audiencestringSiapa yang boleh mengambil.all — Semua.followers — Hanya pengikut pemberi hadiah.group — Hanya anggota grup postingan. newAccountsbooleanApakah akun yang berumur kurang dari 7 hari juga boleh mengambil. statusstringStatusnya.awaiting_payment — Menunggu pembayaran; postingan belum tayang.open — Masih ada tempat yang bisa diambil.closed — Selesai: semua diambil, pembayaran dikembalikan, atau postingan dihapus. claimedbooleanApakah kamu sendiri sudah punya tempat (selalu false di jalur publik).
Contoh {
"item": "plan",
"quantity": 3,
"places": 10,
"left": 4,
"audience": "followers",
"newAccounts": false,
"status": "open",
"claimed": true
}OwnGiftDropHadiahmu di sebuah postingan, beserta postingan dan pembayarannya.
Semua field dari GiftDrop
Field Tipe Arti postIdstringPostingan tempat hadiah itu berada. fundingstringBagaimana dibayar.free — Gratis.quota — Dari kuota.payment — Dibayar. createdAtintegerKapan dibuat.
Contoh {
"item": "plan",
"quantity": 3,
"places": 10,
"left": 4,
"audience": "followers",
"newAccounts": false,
"status": "open",
"claimed": false,
"postId": "5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1",
"funding": "quota",
"createdAt": 1758624000000
}QuotaIsi sebuah kuota.
Field Tipe Arti monthsintegerBulan paket yang masih bisa diberikan. sparksintegerPercikan yang masih bisa diberikan. looksQuotaLook[]Tampilan di stok yang masih bisa diberikan (sejak 2.13).
Contoh {
"months": 120,
"sparks": 500,
"looks": [
{
"id": "frame-gold",
"name": "Goldring",
"kind": "frame",
"quantity": 25
}
]
}QuotaLookTampilan dalam stok mitra, dengan sisa unitnya (sejak 2.13).
Field Tipe Arti idstringID tampilan; kirim sebagai itemId saat memberikannya. namestringNama tampilan. kindstringJenis tampilan.frame — Bingkai profil.background — Efek sampul.card — Kartu profil. quantityintegerBerapa unit yang tersisa.
Contoh {
"id": "frame-gold",
"name": "Goldring",
"kind": "frame",
"quantity": 25
}QuotaGiftHadiah dari kuota.
Field Tipe Arti itemstringApa yang diberikan.plan — Bulan paket (Pendukung).sparks — Percikan.shop — Tampilan dari stok (sejak 2.13). quantityintegerBerapa banyak. itemIdstringatau null Tampilan yang diberikan jika item adalah shop; jika tidak, null. recipientActorKepada siapa. createdAtintegerKapan.
Contoh {
"item": "plan",
"quantity": 3,
"itemId": null,
"recipient": {
"handle": "jon",
"name": "Jon"
},
"createdAt": 1758627600000
}EmbedAlamat untuk situs web lain. Berfungsi tanpa kunci.
Field Tipe Arti pagestringPemutar untuk <iframe>. filestringFile MP4 untuk pemutarmu sendiri. posterstringGambar pratinjau. codestringKode sematan yang siap pakai.
Contoh {
"page": "https://tellmelo.com/media-embed/b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918",
"file": "https://tellmelo.com/media-embed/b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918/file",
"poster": "https://tellmelo.com/media-embed/b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918/poster",
"code": "<iframe src=\"https://tellmelo.com/media-embed/b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918\" width=\"480\" height=\"300\" title=\"Happy bees\" style=\"border:0;max-width:100%\" loading=\"lazy\" allowfullscreen></iframe>"
}UploadStartedUnggahan yang sudah dimulai.
Field Tipe Arti uploadstringID unggahan ini. pieceintegerUkuran maksimal satu potongan, dalam byte.
Contoh {
"upload": "e7c1a2b3-4d5e-4f60-8a9b-0c1d2e3f4a5b",
"piece": 4194304
}UploadPiecePotongan yang sudah diterima.
Field Tipe Arti receivedintegerBerapa byte yang sudah diterima. itemMediaItematau null Setelah potongan terakhir, GIF atau video baru; jika tidak, null.
Contoh {
"received": 4194304,
"item": null
}CreatedJawaban dari penulisan yang membuat sesuatu.
Field Tipe Arti idstringid dari yang dibuat. scheduledForintegeratau null Kapan muncul, jika penerbitan dijadwalkan (selain itu null). deleteAtintegeratau null Kapan menghapus diri, jika diatur (selain itu null).
Contoh {
"id": "5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1",
"scheduledFor": null,
"deleteAt": null
}DropCreatedJawaban saat postingan berisi hadiah dibuat.
Field Tipe Arti idstringid postingan baru. fundingstringBagaimana hadiahnya dibayar.free — Gratis.quota — Dari kuota.
Contoh {
"id": "5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1",
"funding": "quota"
}MadeApa yang baru saja dibuat atau diubah.
Field Tipe Arti idstringid; untuk tautan undangan, kodenya.
Contoh {
"id": "0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a"
}OkJawaban dari penulisan yang tidak punya apa pun untuk dikembalikan.
Field Tipe Arti okbooleanSelalu true.
Contoh {
"ok": true
}Deskripsi yang bisa dibaca mesin Tabel di balik halaman ini tersedia sebagai OpenAPI di https://api.tellmelo.com/v2/openapi.json.
https://api.tellmelo.com/v2/openapi.jsonGIF dan video di situs web lain Apa yang dibagikan anggota dan juga diizinkan di situs web lain bisa ditampilkan situs web mana pun: pencarian dengan anywhere=true menemukannya, dan embed-nya berisi alamatnya. Jika anggota menariknya kembali, itu hilang dari sana dalam beberapa menit.
Mengunggah per potongan Mulai dulu, lalu kirim file dalam potongan. Bagi file yang lebih besar menjadi potongan piece byte, dengan offset di posisi masing-masing. Setelah potongan terakhir, kamu mendapat GIF atau video yang sudah jadi.
curl -X POST -H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/json" \
-d '{"kind":"gif","size":2400000,"name":"Happy bees","shared":true,"anywhere":true}' \
"https://api.tellmelo.com/v2/media/uploads"
→ { "upload": "e7c1a2b3-4d5e-4f60-8a9b-0c1d2e3f4a5b", "piece": 4194304 }
curl -X PUT -H "Authorization: Bearer tm_key_…" \
-H "Content-Type: application/octet-stream" \
--data-binary @bees.gif \
"https://api.tellmelo.com/v2/media/uploads/e7c1a2b3-4d5e-4f60-8a9b-0c1d2e3f4a5b?offset=0"
→ { "received": 2400000, "item": { "id": "…", "embed": { … } } }Menyematkan Pemutar menampilkan GIF berulang atau video dengan kontrol, di bawahnya nama dan siapa yang membagikannya. Taruh kode dari embed.code di halaman:
<iframe src="https://tellmelo.com/media-embed/b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918" width="480" height="300" title="Happy bees" style="border:0;max-width:100%" loading="lazy" allowfullscreen></iframe>Forum dan program yang mengenal oEmbed mengambil kodenya sendiri jika diberi alamat pemutar:
https://tellmelo.com/api/oembed?url=https%3A%2F%2Ftellmelo.com%2Fmedia-embed%2Fb2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918Tempat kunci ada di servermu, jangan pernah di kode halaman web. Cari dan unggah lewat servermu; alamat di embed tidak butuh kunci.
Pemilih GIF untuk situs webmu Dengan kunci situs (Area pengembang → Pemilih GIF untuk situs webmu ), situs webmu mendapat pencarian siap pakai: dua baris di halaman, dan satu klik pada tombol membukanya. Kuncinya bersifat publik dan hanya berfungsi di alamat yang kamu masukkan untuknya. Pemilih hanya menampilkan apa yang diizinkan anggota untuk situs web lain.
<script src="https://tellmelo.com/picker.js" data-key="tmsk_…" defer></script>
<button type="button" data-tellmelo-picker>GIF</button>Saat sesuatu dipilih, tombol memicu tellmelo:pick dengan item tersebut: code untuk menyematkannya, file, poster, name, dan author. Dengan data-target="#field", tombol langsung memasukkan code ke kolom teks; dengan data-kind="video", tombol mencari video. Kalau kamu menyematkan file sendiri, tampilkan nama orang yang membagikannya.
document.addEventListener('tellmelo:pick', (event) => {
const { code, file, name, author } = event.detail;
});Masuk dengan tellmelo Situs lain membiarkan anggota masuk dengan akun tellmelo mereka lewat OpenID Connect (kode otorisasi dengan PKCE). Situs hanya menerima nama pengguna, alamat email yang dikonfirmasi, dan ID miliknya sendiri per anggota (sub).
Kamu mengajukan aplikasi di “Area pengembang → Masuk dengan tellmelo”. Tim memeriksa setiap aplikasi; setelah itu kamu melihat ID klien di sana dan, untuk aplikasi dengan server, membuat rahasia klien yang ditampilkan sekali.
Semua yang dibutuhkan pustaka ada di dokumen discovery:
https://tellmelo.com/.well-known/openid-configurationKirim anggota ke /oauth/authorize dengan response_type=code, client_id, redirect_uri (persis seperti yang didaftarkan), scope=openid profile email, state, nonce, dan code_challenge dengan code_challenge_method=S256. Tukarkan kode dalam satu menit di /oauth/token: grant_type=authorization_code, code, redirect_uri, dan code_verifier; aplikasi dengan server juga mengirim rahasianya, dengan autentikasi Basic atau di formulir. Token ID (RS256, kunci di /oauth/jwks) berisi sub, dengan profile juga preferred_username, dengan email juga email dan email_verified. Token akses berlaku 10 menit dan hanya membaca /oauth/userinfo. https://tellmelo.com/oauth/authorize?response_type=code&client_id=tm_…
&redirect_uri=https%3A%2F%2Fexample.com%2Fcallback&scope=openid%20profile%20email
&state=…&nonce=…&code_challenge=…&code_challenge_method=S256
curl -u "tm_…:tms_…" https://tellmelo.com/oauth/token \
-d grant_type=authorization_code -d code=… \
-d redirect_uri=https://example.com/callback -d code_verifier=…{
"iss": "https://example.social",
"sub": "Xq3vR0b8yJm1cW4tZ2kPn6sLd9fHa7gE5uTo0iBeVxY",
"aud": "tm_5f2c9e1a7b3d4c6e8f0a1b2c",
"iat": 1760432400,
"exp": 1760433000,
"nonce": "n-0S6_WzA2Mj",
"at_hash": "HK6E_P6Dh8Y93mRNtsDB1Q",
"preferred_username": "anna",
"email": "anna@example.com",
"email_verified": true
}Tidak ada token penyegaran: tellmelo hanya memasukkan dan tidak memberi akses permanen. Jika anggota menghapus situs atau tim menangguhkan aplikasi, /oauth/userinfo langsung menjawab 401. prompt=none memeriksa tanpa halaman, prompt=consent bertanya lagi.
Yang kami harapkan Aturannya sama seperti di mana pun: tanpa pelecehan, tanpa spam, tanpa konten yang bukan hakmu. Kamu bertanggung jawab atas apa yang diposting kuncimu.
Tampilkan GIF dan video orang lain di situs webmu hanya jika punya embed, lewat alamat tersebut dan dengan nama orang yang membagikannya. Jika sesuatu tidak tersedia lagi, berhenti menampilkannya. Jangan salin file ke koleksimu sendiri.
