API

Ini adalah terjemahan. Versi bahasa Jerman yang berlaku. Jika teks ini berbeda darinya, teks bahasa Jerman yang berlaku. Kamu bisa mengganti bahasa di bagian bawah halaman.

Isi

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 path diawali /api/v2 di alamat instans ini.
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://tellmelo.com/api/v2

Mulai cepat

Buat kunci di “Pengaturan → Aplikasi & data → 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://tellmelo.com/api/v2

{
  "name": "tellmelo",
  "version": "2.10",
  "scope": "read write",
  "rateLimit": {
    "limit": 120,
    "remaining": 117
  },
  "docs": "/legal/api",
  "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

read Versi API dan nama instans ini.

curl \
  -H "Authorization: Bearer $TELLMELO_KEY" \
  "https://tellmelo.com/api/v2"

KuncimuHanya tersimpan di halaman ini sampai kamu menutupnya.

Kuncimu

Satu kunci per akun. Kunci diawali tm_key_ dan hanya ditampilkan sekali. Hilang? Buat yang baru; yang lama berhenti berfungsi.

Kamu membuatnya di “Pengaturan → Aplikasi & data → API”. Kunci dikirim di header permintaan:

curl -H "Authorization: Bearer tm_key_…" \
  https://tellmelo.com/api/v2/posts

Atau, jika lebih praktis, di header tersendiri:

curl -H "X-Tellmelo-Key: tm_key_…" https://tellmelo.com/api/v2

Jangan 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://tellmelo.com/api/media?id=…"

Apa yang boleh dilakukan kunci

Kunci punya salah satu dari dua hak, dan setiap path di bawah menyebutkan hak yang diperlukan:

read: membaca. Postingan publik, profil, grup, dan tag, ditambah feed, notifikasi, dan pesanmu.
write: bertindak. Memposting, membalas, memilih, mengirim pesan, mengikuti, bergabung, memblokir, menandai notifikasi sudah dibaca.

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.

Permintaan dan jawaban

JSON di mana-mana. Setiap jawaban adalah application/json dalam UTF-8, termasuk galat. Hanya gambar yang datang sebagai gambar.
Yang kamu kirim. POST membawa field-nya sebagai JSON di isi. Jika field juga ada di URL, isi yang menang.
Waktu dalam milidetik sejak 1 Januari 1970, UTC.
ID berupa string. Bandingkan hanya secara utuh.
Setiap field selalu ada. Yang tidak ada bernilai null; daftar bisa kosong.
Teks berupa teks polos, persis seperti ditulis. #tag, @nama, dan tautan tetap seperti adanya, begitu pula emoji milik instans, sebagai :nama:; gambarnya tercantum di /emojis.
Gambar berupa alamat relatif, /api/media?id=…. Tanpa kunci di header kamu mendapat 401.

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://tellmelo.com/api/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"  →  304

Pengecualian: /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: 1758624060

Penulisan juga dihitung terhadap batas aplikasi, misalnya berapa postingan dalam beberapa menit. Itu juga menjawab 429 dengan rate_limited.

Header

Selain kunci, tidak ada header yang wajib.

Yang kamu kirim

Header	Arti
`Authorization`	Membawa kunci: `Bearer tm_key_…`. Cara yang biasa.
`X-Tellmelo-Key`	Kunci, sebagai alternatif `Authorization`.
`Content-Type`	`application/json`, untuk permintaan dengan isi.
`If-None-Match`	`ETag` dari jawaban terakhir. Jika tidak ada yang berubah sejak itu, jawabannya `304` tanpa isi.

Yang kembali

Header	Arti
`ETag`	Sidik jari jawaban ini (`W/`). Kirim kembali sebagai `If-None-Match`.
`X-RateLimit-Limit`	Berapa permintaan per menit yang boleh dibuat kunci ini.
`X-RateLimit-Remaining`	Berapa yang tersisa di menit ini.
`X-RateLimit-Reset`	Kapan menit berikutnya dimulai, dalam detik sejak 1970, UTC.
`X-Tellmelo-Scope`	Apa yang boleh dilakukan kunci ini: `read` atau `read write`.
`Retry-After`	Dengan `429`: berapa detik menunggu sebelum bertanya lagi.
`WWW-Authenticate`	Pada `401` tanpa kunci: `Bearer`.
`Cache-Control`	`no-store`: tidak ada proxy yang boleh menyimpan jawaban. Kamu tetap bisa memeriksanya dengan `ETag`.

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
`400`	`bad_request`	Permintaan tidak terbaca, field wajib tidak ada, atau nilainya tidak diizinkan.
`401`	`key_missing`	Tidak ada kunci di header.
`401`	`key_invalid`	Kuncinya tidak valid: salah ketik, sudah diganti, atau akunnya dilarang.
`401`	`unauthorized`	Ditolak sebagai belum masuk, karena alasan selain kunci.
`403`	`scope_missing`	Kunci tidak punya hak yang diperlukan, biasanya `write`.
`403`	`account_data_locked`	Data akun seperti kata sandi, alamat email, atau penghapusan tidak bisa dijangkau kunci.
`403`	`forbidden`	Akunmu tidak boleh melakukan ini, misalnya karena hak dicabut atau blokir.
`404`	`unknown_path`	Path ini tidak ada, atau tidak dengan metode ini.
`404`	`not_found`	Tidak ditemukan, atau kamu tidak boleh melihatnya.
`409`	`conflict`	Bertabrakan dengan yang sudah ada, misalnya nama yang sudah dipakai.
`413`	`too_large`	Terlalu besar untuk instans ini.
`422`	`unprocessable`	Terbaca, tetapi tidak mungkin dalam bentuk ini.
`429`	`rate_limited`	Terlalu banyak permintaan. Tidak terjadi apa-apa; tunggu dan coba lagi.
`500`	`internal_error`	Ada 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.

/api/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`/api/v2`	`read`	Versi API dan nama instans ini.
Postingan
GET`/api/v2/posts`	`read`	Postingan publik, yang terbaru lebih dulu.
GET`/api/v2/posts/{id}`	`read`	Satu postingan, menurut `id`-nya.
POST`/api/v2/posts`	`write`	Terbitkan postingan.
DELETE`/api/v2/posts/{id}`	`write`	Hapus salah satu postinganmu sendiri.
Balasan
GET`/api/v2/posts/{id}/replies`	`read`	Balasan untuk sebuah postingan, tanpa akun yang diblokir.
POST`/api/v2/posts/{id}/replies`	`write`	Balas sebuah postingan.
Jajak pendapat
POST`/api/v2/posts/{id}/vote`	`write`	Ikut dalam jajak pendapat.
Profil
GET`/api/v2/profiles/{handle}`	`read`	Sebuah profil, menurut nama pendeknya.
GET`/api/v2/profiles/{handle}/posts`	`read`	Postingan publik dari satu profil, yang terbaru lebih dulu.
Grup
GET`/api/v2/communities`	`read`	Grup terbuka di instans ini.
GET`/api/v2/communities/{id}`	`read`	Satu grup, menurut `id`-nya.
GET`/api/v2/communities/{id}/posts`	`read`	Postingan publik dari satu grup, yang terbaru lebih dulu.
Jelajahi
GET`/api/v2/tags`	`read`	Tag yang sedang ramai.
GET`/api/v2/search`	`read`	Pencarian di postingan, nama, nama pendek, dan tag.
GET`/api/v2/emojis`	`read`	Emoji milik instans, dengan alamat gambarnya.
Akunmu
GET`/api/v2/me`	`read`	Profilmu sendiri, dengan `id` yang diharapkan path lain.
GET`/api/v2/feed`	`read`	Feed-mu sendiri, seperti yang disusun aplikasi.
Notifikasi
GET`/api/v2/notifications`	`read`	Notifikasimu, yang terbaru lebih dulu.
POST`/api/v2/notifications/read`	`write`	Tandai notifikasimu sudah dibaca.
Pesan
GET`/api/v2/conversations`	`read`	Kotak masukmu: satu baris per percakapan, yang terbaru lebih dulu.
GET`/api/v2/conversations/{with}/messages`	`read`	Pesan dalam satu percakapan, yang terbaru lebih dulu.
POST`/api/v2/conversations/{with}/messages`	`write`	Kirim pesan dalam percakapan.
POST`/api/v2/conversations/{with}/read`	`write`	Tandai semua pesan dalam percakapan sudah dibaca.
Relasi
POST`/api/v2/relations`	`write`	Suka, simpan, posting ulang, ikuti, gabung, blokir, bisukan, tergantung `kind`.

Jalan masuk

Permintaan pertama setiap program: apakah kuncinya berfungsi, dan apa yang boleh dilakukannya?

GET`/api/v2`

Versi API dan nama instans ini.

Hak read
dengan ETag
sejak v2.0

Tanpa garis miring di akhir: /api/v2/ dialihkan ke /api/v2 dengan 308, dan tidak setiap program mengikutinya.

Contoh permintaan

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://tellmelo.com/api/v2"

Jawaban

Menjawab dengan satu Service.

Contoh

{
  "name": "tellmelo",
  "version": "2.10",
  "scope": "read write",
  "rateLimit": {
    "limit": 120,
    "remaining": 117
  },
  "docs": "/legal/api",
  "spec": "/api/v2/openapi.json"
}

Status yang mungkin: 200304401429

Postingan

Membaca postingan publik, menerbitkan milikmu sendiri, dan menghapusnya lagi.

GET`/api/v2/posts`

Postingan 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
`limit`di query	`integer`opsional	Entri per halaman: 20 secara bawaan, maksimal 50.
`cursor`di query	`string`opsional	`next` dari jawaban sebelumnya. Tanpa itu, dari awal.

Contoh permintaan

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://tellmelo.com/api/v2/posts?limit=20"

Jawaban

Menjawab dengan satu halaman Post, sebagai `items` dan `next`.

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
        }
      ],
      "poll": {
        "options": [
          {
            "text": "Lavender",
            "votes": 12
          },
          {
            "text": "Sunflowers",
            "votes": 7
          },
          {
            "text": "Clover",
            "votes": 3
          }
        ],
        "total": 22,
        "multiple": false,
        "endsAt": 1758710400000,
        "running": true,
        "resultsVisible": true,
        "myVotes": [
          0
        ]
      },
      "quotes": null,
      "continues": null,
      "counts": {
        "replies": 4,
        "likes": 31,
        "reposts": 2
      },
      "pinned": false,
      "createdAt": 1758624000000
    }
  ],
  "next": "MTc1ODYyNDAwMDAwMDo1ZjBjMmE5ZS04ZDQx"
}

Status yang mungkin: 200304401429

GET`/api/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
`id`di path	`string`wajib	`id` sebuah postingan.

Contoh permintaan

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://tellmelo.com/api/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
    }
  ],
  "poll": {
    "options": [
      {
        "text": "Lavender",
        "votes": 12
      },
      {
        "text": "Sunflowers",
        "votes": 7
      },
      {
        "text": "Clover",
        "votes": 3
      }
    ],
    "total": 22,
    "multiple": false,
    "endsAt": 1758710400000,
    "running": true,
    "resultsVisible": true,
    "myVotes": [
      0
    ]
  },
  "quotes": null,
  "continues": null,
  "counts": {
    "replies": 4,
    "likes": 31,
    "reposts": 2
  },
  "pinned": false,
  "createdAt": 1758624000000
}

Status yang mungkin: 200304400401404429

POST`/api/v2/posts`

Terbitkan postingan.

Hak write
sejak v2.0

Postingan perlu teks atau jajak pendapat. Panjang, pilihan jajak pendapat, dan laju diatur instans; di luar itu kamu mendapat 400 atau 429.

Gambar belum bisa dilampirkan lewat API, hanya di aplikasi.

Parameter

Nama	Tipe	Arti
`text`di isi	`string`opsional	Teks postingan, balasan, atau pesan.
`community`di isi	`string`opsional	`id` grup tempat postingan masuk. Tanpa itu, di luar semua grup.
`quotes`di isi	`string`opsional	`id` postingan yang dikutip postingan ini.
`poll`di isi	`string[]`opsional	Pilihan jawaban sebagai daftar teks.

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://tellmelo.com/api/v2/posts"

Jawaban

Menjawab dengan satu Created.

Contoh

{
  "id": "5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1",
  "scheduledFor": null,
  "deleteAt": null
}

Status yang mungkin: 200400401403429

DELETE`/api/v2/posts/{id}`

Hapus salah satu postinganmu sendiri.

Hak write
sejak v2.0

Parameter

Nama	Tipe	Arti
`id`di path	`string`wajib	`id` sebuah postingan.

Contoh permintaan

curl -X DELETE \
  -H "Authorization: Bearer tm_key_…" \
  "https://tellmelo.com/api/v2/posts/5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1"

Jawaban

Menjawab dengan satu Ok.

Contoh

{
  "ok": true
}

Status yang mungkin: 200400401403404429

Balasan

Balasan di bawah postingan, sebagai daftar dengan parentId.

GET`/api/v2/posts/{id}/replies`

Balasan 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
`id`di path	`string`wajib	`id` sebuah postingan.
`limit`di query	`integer`opsional	Entri per halaman: 20 secara bawaan, maksimal 50.
`cursor`di query	`string`opsional	`next` dari jawaban sebelumnya. Tanpa itu, dari awal.

Contoh permintaan

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://tellmelo.com/api/v2/posts/5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1/replies?limit=20"

Jawaban

Menjawab dengan satu halaman Reply, sebagai `items` dan `next`.

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,
      "createdAt": 1758624600000,
      "postId": "5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1",
      "parentId": null
    }
  ],
  "next": "MTc1ODYyNDAwMDAwMDo1ZjBjMmE5ZS04ZDQx"
}

Status yang mungkin: 200304400401404429

POST`/api/v2/posts/{id}/replies`

Balas sebuah postingan.

Hak write
sejak v2.0

Dalam mode lambat, satu balasan per orang setiap 10 menit, selain itu 429. Penulis dan akun yang diikutinya dikecualikan.

Parameter

Nama	Tipe	Arti
`id`di path	`string`wajib	`id` sebuah postingan.
`text`di isi	`string`wajib	Teks postingan, balasan, atau pesan.
`parentId`di isi	`string`opsional	`id` balasan yang dijawab balasan ini. Tanpa itu, langsung ke postingan.

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://tellmelo.com/api/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

Jajak pendapat

Jajak pendapat adalah postingan yang poll-nya diisi. Memilih punya path sendiri.

POST`/api/v2/posts/{id}/vote`

Ikut dalam jajak pendapat.

Hak write
sejak v2.0

Suara per pilihan bernilai null sampai kamu memilih atau jajak pendapat berakhir. total selalu ada.

Parameter

Nama	Tipe	Arti
`id`di path	`string`wajib	`id` sebuah postingan.
`option`di isi	`integer`wajib	Pilihan mana, dihitung dari 0. Untuk pilihan ganda, panggil sekali per pilihan.
`retract`di isi	`boolean`opsional	`true` menarik suara.

Contoh permintaan

curl -X POST \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/json" \
  -d '{"option":0}' \
  "https://tellmelo.com/api/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`/api/v2/profiles/{handle}`

Sebuah profil, menurut nama pendeknya.

Hak read
dengan ETag
sejak v2.0

Parameter

Nama	Tipe	Arti
`handle`di path	`string`wajib	Nama pendek sebuah profil.

Contoh permintaan

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://tellmelo.com/api/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`/api/v2/profiles/{handle}/posts`

Postingan 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
`handle`di path	`string`wajib	Nama pendek sebuah profil.
`limit`di query	`integer`opsional	Entri per halaman: 20 secara bawaan, maksimal 50.
`cursor`di query	`string`opsional	`next` dari jawaban sebelumnya. Tanpa itu, dari awal.

Contoh permintaan

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://tellmelo.com/api/v2/profiles/mara/posts?limit=20"

Jawaban

Menjawab dengan satu halaman Post, sebagai `items` dan `next`.

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
        }
      ],
      "poll": {
        "options": [
          {
            "text": "Lavender",
            "votes": 12
          },
          {
            "text": "Sunflowers",
            "votes": 7
          },
          {
            "text": "Clover",
            "votes": 3
          }
        ],
        "total": 22,
        "multiple": false,
        "endsAt": 1758710400000,
        "running": true,
        "resultsVisible": true,
        "myVotes": [
          0
        ]
      },
      "quotes": null,
      "continues": null,
      "counts": {
        "replies": 4,
        "likes": 31,
        "reposts": 2
      },
      "pinned": false,
      "createdAt": 1758624000000
    }
  ],
  "next": "MTc1ODYyNDAwMDAwMDo1ZjBjMmE5ZS04ZDQx"
}

Status yang mungkin: 200304400401404429

Grup

Grup terbuka dan postingannya.

GET`/api/v2/communities`

Grup terbuka di instans ini.

Hak read
dengan ETag
sejak v2.0

Diurutkan menurut jumlah anggota dan tidak berhalaman; next selalu null.

Parameter

Nama	Tipe	Arti
`limit`di query	`integer`opsional	Entri per halaman: 20 secara bawaan, maksimal 50.

Contoh permintaan

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://tellmelo.com/api/v2/communities?limit=20"

Jawaban

Menjawab dengan satu halaman Community, sebagai `items` dan `next`.

Contoh

{
  "items": [
    {
      "id": "c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60",
      "name": "Urban Gardening",
      "description": "Balconies, allotments, rooftops: whatever grows.",
      "tags": [
        "garden",
        "bees"
      ],
      "members": 312,
      "joinPolicy": "open",
      "visibility": "open"
    }
  ],
  "next": null
}

Status yang mungkin: 200304401429

GET`/api/v2/communities/{id}`

Satu grup, menurut id-nya.

Hak read
dengan ETag
sejak v2.0

Parameter

Nama	Tipe	Arti
`id`di path	`string`wajib	`id` sebuah grup.

Contoh permintaan

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://tellmelo.com/api/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60"

Jawaban

Menjawab dengan satu Community.

Contoh

{
  "id": "c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60",
  "name": "Urban Gardening",
  "description": "Balconies, allotments, rooftops: whatever grows.",
  "tags": [
    "garden",
    "bees"
  ],
  "members": 312,
  "joinPolicy": "open",
  "visibility": "open"
}

Status yang mungkin: 200304400401404429

GET`/api/v2/communities/{id}/posts`

Postingan publik dari satu grup, 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.

Parameter

Nama	Tipe	Arti
`id`di path	`string`wajib	`id` sebuah grup.
`limit`di query	`integer`opsional	Entri per halaman: 20 secara bawaan, maksimal 50.
`cursor`di query	`string`opsional	`next` dari jawaban sebelumnya. Tanpa itu, dari awal.

Contoh permintaan

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://tellmelo.com/api/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/posts?limit=20"

Jawaban

Menjawab dengan satu halaman Post, sebagai `items` dan `next`.

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
        }
      ],
      "poll": {
        "options": [
          {
            "text": "Lavender",
            "votes": 12
          },
          {
            "text": "Sunflowers",
            "votes": 7
          },
          {
            "text": "Clover",
            "votes": 3
          }
        ],
        "total": 22,
        "multiple": false,
        "endsAt": 1758710400000,
        "running": true,
        "resultsVisible": true,
        "myVotes": [
          0
        ]
      },
      "quotes": null,
      "continues": null,
      "counts": {
        "replies": 4,
        "likes": 31,
        "reposts": 2
      },
      "pinned": false,
      "createdAt": 1758624000000
    }
  ],
  "next": "MTc1ODYyNDAwMDAwMDo1ZjBjMmE5ZS04ZDQx"
}

Status yang mungkin: 200304400401404429

Jelajahi

Tren, pencarian, dan emoji milik instans.

GET`/api/v2/tags`

Tag 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
`limit`di query	`integer`opsional	Entri per halaman: 20 secara bawaan, maksimal 50.

Contoh permintaan

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://tellmelo.com/api/v2/tags?limit=10"

Jawaban

Menjawab dengan satu halaman Tag, sebagai `items` dan `next`.

Contoh

{
  "items": [
    {
      "tag": "garden",
      "posts": 58
    }
  ],
  "next": null
}

Status yang mungkin: 200304401429

GET`/api/v2/search`

Pencarian 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
`q`di query	`string`wajib	Kata yang dicari.
`type`di query	`string`opsional	Jenis hasil mana. Tanpa itu, semua jenis.`allpostsprofilestags`
`limit`di query	`integer`opsional	Entri per halaman: 20 secara bawaan, maksimal 50.

Contoh permintaan

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://tellmelo.com/api/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
        }
      ],
      "poll": {
        "options": [
          {
            "text": "Lavender",
            "votes": 12
          },
          {
            "text": "Sunflowers",
            "votes": 7
          },
          {
            "text": "Clover",
            "votes": 3
          }
        ],
        "total": 22,
        "multiple": false,
        "endsAt": 1758710400000,
        "running": true,
        "resultsVisible": true,
        "myVotes": [
          0
        ]
      },
      "quotes": null,
      "continues": null,
      "counts": {
        "replies": 4,
        "likes": 31,
        "reposts": 2
      },
      "pinned": false,
      "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`/api/v2/emojis`

Emoji 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://tellmelo.com/api/v2/emojis"

Jawaban

Menjawab dengan satu halaman Emoji, sebagai `items` dan `next`.

Contoh

{
  "items": [
    {
      "name": "tellmelo",
      "url": "/api/media?id=e1f2a3b4-c5d6-4e7f-8a9b-0c1d2e3f4a5b"
    }
  ],
  "next": null
}

Status yang mungkin: 200304401429

Akunmu

Profil dan feed-mu.

GET`/api/v2/me`

Profilmu sendiri, dengan id yang diharapkan path lain.

Hak read
dengan ETag
sejak v2.0

Contoh permintaan

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://tellmelo.com/api/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`/api/v2/feed`

Feed-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
`tab`di query	`string`opsional	Feed mana: `for-you`, `following`, `latest`, atau `bookmarks`. `latest` secara bawaan.`for-youfollowinglatestbookmarks`
`tag`di query	`string`opsional	Hanya postingan tentang tag ini: ditulis dengannya atau dikenali server di dalamnya. Tanpa itu, tanpa filter.
`limit`di query	`integer`opsional	Entri per halaman: 20 secara bawaan, maksimal 50.
`cursor`di query	`string`opsional	`next` dari jawaban sebelumnya. Tanpa itu, dari awal.

Contoh permintaan

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://tellmelo.com/api/v2/feed?tab=following&limit=20"

Jawaban

Menjawab dengan satu halaman Post, sebagai `items` dan `next`.

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
        }
      ],
      "poll": {
        "options": [
          {
            "text": "Lavender",
            "votes": 12
          },
          {
            "text": "Sunflowers",
            "votes": 7
          },
          {
            "text": "Clover",
            "votes": 3
          }
        ],
        "total": 22,
        "multiple": false,
        "endsAt": 1758710400000,
        "running": true,
        "resultsVisible": true,
        "myVotes": [
          0
        ]
      },
      "quotes": null,
      "continues": null,
      "counts": {
        "replies": 4,
        "likes": 31,
        "reposts": 2
      },
      "pinned": false,
      "createdAt": 1758624000000
    }
  ],
  "next": "MTc1ODYyNDAwMDAwMDo1ZjBjMmE5ZS04ZDQx"
}

Status yang mungkin: 200400401429

Notifikasi

Apa yang terjadi di sekitar akunmu, halaman demi halaman.

GET`/api/v2/notifications`

Notifikasimu, 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
`limit`di query	`integer`opsional	Entri per halaman: 20 secara bawaan, maksimal 50.
`cursor`di query	`string`opsional	`next` dari jawaban sebelumnya. Tanpa itu, dari awal.

Contoh permintaan

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://tellmelo.com/api/v2/notifications?limit=20"

Jawaban

Menjawab dengan satu halaman Notification, sebagai `items` dan `next`.

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`/api/v2/notifications/read`

Tandai notifikasimu sudah dibaca.

Hak write
sejak v2.0

Contoh permintaan

curl -X POST \
  -H "Authorization: Bearer tm_key_…" \
  "https://tellmelo.com/api/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`/api/v2/conversations`

Kotak masukmu: satu baris per percakapan, yang terbaru lebih dulu.

Hak read
berhalaman
dengan ETag
sejak v2.0

Parameter

Nama	Tipe	Arti
`limit`di query	`integer`opsional	Entri per halaman: 20 secara bawaan, maksimal 50.
`cursor`di query	`string`opsional	`next` dari jawaban sebelumnya. Tanpa itu, dari awal.

Contoh permintaan

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://tellmelo.com/api/v2/conversations?limit=20"

Jawaban

Menjawab dengan satu halaman Conversation, sebagai `items` dan `next`.

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`/api/v2/conversations/{with}/messages`

Pesan 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
`with`di path	`string`wajib	`id` akun lainnya. Percakapan tidak punya `id` sendiri.
`limit`di query	`integer`opsional	Entri per halaman: 20 secara bawaan, maksimal 50.
`cursor`di query	`string`opsional	`next` dari jawaban sebelumnya. Tanpa itu, dari awal.

Contoh permintaan

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://tellmelo.com/api/v2/conversations/a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05/messages?limit=20"

Jawaban

Menjawab dengan satu halaman Message, sebagai `items` dan `next`.

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`/api/v2/conversations/{with}/messages`

Kirim pesan dalam percakapan.

Hak write
sejak v2.0

Aturan aplikasi berlaku: yang memblokirmu tidak bisa dijangkau, dan pengaturan orang lain diperhitungkan.

Gambar belum bisa dilampirkan lewat API, hanya di aplikasi.

Parameter

Nama	Tipe	Arti
`with`di path	`string`wajib	`id` akun lainnya. Percakapan tidak punya `id` sendiri.
`text`di isi	`string`wajib	Teks postingan, balasan, atau pesan.
`replyTo`di isi	`string`opsional	`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://tellmelo.com/api/v2/conversations/a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05/messages"

Jawaban

Menjawab dengan satu Ok.

Contoh

{
  "ok": true
}

Status yang mungkin: 200400401403404429

POST`/api/v2/conversations/{with}/read`

Tandai semua pesan dalam percakapan sudah dibaca.

Hak write
sejak v2.1

Parameter

Nama	Tipe	Arti
`with`di path	`string`wajib	`id` akun lainnya. Percakapan tidak punya `id` sendiri.

Contoh permintaan

curl -X POST \
  -H "Authorization: Bearer tm_key_…" \
  "https://tellmelo.com/api/v2/conversations/a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05/read"

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.

POST`/api/v2/relations`

Suka, simpan, posting ulang, ikuti, gabung, blokir, bisukan, tergantung kind.

Hak write
sejak v2.0

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
`kind`di isi	`string`wajib	Relasi mana: `like`, `save`, `repost`, `follow`, `join`, `block`, atau `mute` (sejak 2.2).`likesaverepostfollowjoinblockmute`
`target`di isi	`string`wajib	`id` postingan, profil, atau grup, tergantung `kind`.
`active`di isi	`boolean`opsional	`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://tellmelo.com/api/v2/relations"

Jawaban

Menjawab dengan satu Ok.

Contoh

{
  "ok": true
}

Status yang mungkin: 200400401403429

Objek

Semua objek, field demi field. [] berarti daftar.

`Service`

Jawaban root: siapa yang menjawab, dan apa yang boleh dilakukan kunci ini.

Field	Tipe	Arti
`name`	`string`	Selalu `tellmelo`.
`version`	`string`	Versi API, misalnya `2.1`.
`scope`	`string`	Apa yang boleh dilakukan kunci ini: `read` atau `read write`.
`rateLimit`	`RateLimit`	Jatah kunci ini.
`docs`	`string`	Di mana dokumentasi ini, sebagai path di instans ini.
`spec`	`string`	Di mana deskripsi yang bisa dibaca mesin.

Contoh

{
  "name": "tellmelo",
  "version": "2.10",
  "scope": "read write",
  "rateLimit": {
    "limit": 120,
    "remaining": 117
  },
  "docs": "/legal/api",
  "spec": "/api/v2/openapi.json"
}

`RateLimit`

Jatah kunci ini di menit ini.

Field	Tipe	Arti
`limit`	`integer`	Permintaan per menit.
`remaining`	`integer`	Berapa yang tersisa di menit ini.

Contoh

{
  "limit": 120,
  "remaining": 117
}

`Post`

Sebuah postingan, dengan bentuk yang sama di mana-mana.

Field	Tipe	Arti
`id`	`string`	id postingan.
`text`	`string`atau null	Teks seperti ditulis (`null` untuk postingan yang hanya jajak pendapat atau hanya gambar).
`kind`	`string`	Apa postingan ini. `post` — Postingan dengan teks, gambar, atau kutipan. `poll` — Postingan dengan jajak pendapat.
`author`	`ProfileBrief`	Siapa yang menulisnya.
`community`	`CommunityBrief`atau null	Grup tempat ditulis (`null` di luar semua grup).
`media`	`Media[]`	Gambarnya, berurutan; kosong jika tidak ada.
`poll`	`Poll`atau null	Jajak pendapat (`null` jika tidak ada).
`quotes`	`string`atau null	id postingan yang dikutip postingan ini.
`continues`	`string`atau null	id postingan yang dilanjutkan postingan ini, sebagai tambahan.
`counts`	`Counts`	Balasan, suka, dan posting ulang.
`pinned`	`boolean`	Apakah disematkan di atas profil penulisnya.
`createdAt`	`integer`	Kapan 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
    }
  ],
  "poll": {
    "options": [
      {
        "text": "Lavender",
        "votes": 12
      },
      {
        "text": "Sunflowers",
        "votes": 7
      },
      {
        "text": "Clover",
        "votes": 3
      }
    ],
    "total": 22,
    "multiple": false,
    "endsAt": 1758710400000,
    "running": true,
    "resultsVisible": true,
    "myVotes": [
      0
    ]
  },
  "quotes": null,
  "continues": null,
  "counts": {
    "replies": 4,
    "likes": 31,
    "reposts": 2
  },
  "pinned": false,
  "createdAt": 1758624000000
}

`Reply`

Balasan di bawah postingan: postingan dengan dua field tambahan.

Semua field dari Post, dan sebagai tambahan:

Field	Tipe	Arti
`postId`	`string`	Postingan tempat seluruh percakapan bergantung.
`parentId`	`string`atau 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,
  "createdAt": 1758624600000,
  "postId": "5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1",
  "parentId": null
}

`Counts`

Berapa balasan, suka, dan posting ulang yang dimiliki postingan.

Field	Tipe	Arti
`replies`	`integer`	Balasan, semua tingkat bersama.
`likes`	`integer`	Suka.
`reposts`	`integer`	Posting ulang.

Contoh

{
  "replies": 4,
  "likes": 31,
  "reposts": 2
}

`Media`

Gambar dari postingan atau pesan.

Field	Tipe	Arti
`url`	`string`	Alamat gambar atau video, relatif terhadap instans ini. Muat dengan kunci di header.
`kind`	`string`	`image`, `video`, atau `gif` (sejak 2.10). Video dan GIF adalah file MP4. `image` — Gambar (WebP atau JPEG). `video` — Video sebagai MP4, dengan suara. `gif` — GIF, sebagai MP4 tanpa suara yang berulang.
`poster`	`string`atau null	Untuk video dan GIF, alamat gambar pratinjau; selain itu `null` (sejak 2.10).

Contoh

{
  "url": "/api/media?id=b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918",
  "kind": "image",
  "poster": null
}

`Poll`

Jajak pendapat dari postingan.

Field	Tipe	Arti
`options`	`PollOption[]`	Jawaban-jawabannya, berurutan. `option` dalam pemungutan suara dihitung dari 0.
`total`	`integer`	Semua suara bersama, selalu ada.
`multiple`	`boolean`	Apakah boleh memilih lebih dari satu jawaban.
`endsAt`	`integer`atau null	Kapan jajak pendapat berakhir (`null` jika berjalan tanpa akhir).
`running`	`boolean`	Apakah masih bisa memilih.
`resultsVisible`	`boolean`	Apakah suara per jawaban ditampilkan (lihat `votes`).
`myVotes`	`integer[]`	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": 1758710400000,
  "running": true,
  "resultsVisible": true,
  "myVotes": [
    0
  ]
}

`PollOption`

Satu jawaban dari jajak pendapat.

Field	Tipe	Arti
`text`	`string`	Jawabannya.
`votes`	`integer`atau null	Suaranya (`null` selama hasil ditahan).

Contoh

{
  "text": "Lavender",
  "votes": 12
}

`ProfileBrief`

Profil seperti yang muncul di dalam objek lain: sebagai penulis, dalam pencarian.

Field	Tipe	Arti
`id`	`string`	id akun: yang diharapkan `/relations` dan `/conversations/{with}`.
`handle`	`string`	Nama pendek, tanpa `@`.
`name`	`string`	Nama tampilan. Bisa memuat emoji, termasuk `:name:`.
`verified`	`boolean`	Apakah akun terverifikasi.
`accountKind`	`string`	Jenis akun apa. `person` — Seseorang. `business` — Sebuah usaha. `association` — Klub atau perkumpulan. `automated` — Akun otomatis, seperti bot.

Contoh

{
  "id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
  "handle": "mara",
  "name": "Mara 🌻",
  "verified": true,
  "accountKind": "person"
}

`Profile`

Profil tersendiri, dengan deskripsi dan pengikutnya.

Semua field dari ProfileBrief, dan sebagai tambahan:

Field	Tipe	Arti
`about`	`string`atau null	Deskripsi (`null` jika tidak ada).
`website`	`string`atau null	Situs web profil (`null` jika tidak ada). Sejak 2.3.
`websiteVerified`	`boolean`	Apakah situs web menautkan balik ke profil ini dengan `rel=me`, diperiksa setiap minggu. Sejak 2.3.
`followers`	`integer`	Berapa akun yang mengikutinya.
`createdAt`	`integer`atau 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
}

`CommunityBrief`

Grup tempat postingan ditulis.

Field	Tipe	Arti
`id`	`string`	id grup.
`name`	`string`atau null	Namanya.

Contoh

{
  "id": "c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60",
  "name": "Urban Gardening"
}

`Community`

Grup di instans ini.

Field	Tipe	Arti
`id`	`string`	id grup.
`name`	`string`	Namanya.
`description`	`string`atau null	Deskripsi (`null` jika tidak ada).
`tags`	`string[]`	Topik yang dibahasnya.
`members`	`integer`	Berapa anggotanya.
`joinPolicy`	`string`	Bagaimana cara masuk. `open` — Siapa pun bisa bergabung. `application` — Bergabung memerlukan pendaftaran yang diterima grup. `invite` — Hanya dengan undangan.
`visibility`	`string`	Selalu `open` lewat kunci. `open` — Terlihat oleh semua orang.

Contoh

{
  "id": "c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60",
  "name": "Urban Gardening",
  "description": "Balconies, allotments, rooftops: whatever grows.",
  "tags": [
    "garden",
    "bees"
  ],
  "members": 312,
  "joinPolicy": "open",
  "visibility": "open"
}

`Tag`

Tag dan berapa postingan yang memakainya.

Field	Tipe	Arti
`tag`	`string`	Tag, tanpa `#`.
`posts`	`integer`	Berapa postingan terbaru yang memakainya.

Contoh

{
  "tag": "garden",
  "posts": 58
}

`SearchResult`

Tiga daftar, mungkin kosong.

Field	Tipe	Arti
`posts`	`Post[]`	Postingan yang cocok, terbaru lebih dulu.
`profiles`	`ProfileBrief[]`	Profil yang cocok, menurut nama pendek.
`tags`	`Tag[]`	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
        }
      ],
      "poll": {
        "options": [
          {
            "text": "Lavender",
            "votes": 12
          },
          {
            "text": "Sunflowers",
            "votes": 7
          },
          {
            "text": "Clover",
            "votes": 3
          }
        ],
        "total": 22,
        "multiple": false,
        "endsAt": 1758710400000,
        "running": true,
        "resultsVisible": true,
        "myVotes": [
          0
        ]
      },
      "quotes": null,
      "continues": null,
      "counts": {
        "replies": 4,
        "likes": 31,
        "reposts": 2
      },
      "pinned": false,
      "createdAt": 1758624000000
    }
  ],
  "profiles": [
    {
      "id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
      "handle": "mara",
      "name": "Mara 🌻",
      "verified": true,
      "accountKind": "person"
    }
  ],
  "tags": [
    {
      "tag": "garden",
      "posts": 58
    }
  ]
}

`Emoji`

Emoji di instans ini.

Field	Tipe	Arti
`name`	`string`	Namanya, seperti tertulis di antara titik dua.
`url`	`string`	Alamat gambar, relatif terhadap instans ini.

Contoh

{
  "name": "tellmelo",
  "url": "/api/media?id=e1f2a3b4-c5d6-4e7f-8a9b-0c1d2e3f4a5b"
}

`Notification`

Notifikasi. Satu baris bisa menghimpun beberapa peristiwa sejenis.

Field	Tipe	Arti
`id`	`string`	id notifikasi.
`kind`	`string`	Apa yang terjadi. `reply` — Seseorang membalasmu. `like` — Seseorang menyukai postinganmu. `reply_like` — Seseorang menyukai balasanmu. `repost` — Seseorang memposting ulang postinganmu. `follow` — Seseorang mengikutimu. `mention` — Seseorang menyebutmu. `group_mention` — Seseorang menyebut grup yang kamu pimpin; `text` adalah namanya. `message` — Seseorang mengirimimu pesan. `scheduled` — Postingan terjadwalmu sudah diterbitkan. `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 mencapai level atau hanya bertahan di level itu sementara. `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.
`text`	`string`atau null	Hanya untuk laporan dan moderasi: teks terkait, selain itu `null`.
`actor`	`Actor`	Siapa yang melakukannya.
`postId`	`string`atau null	Postingan yang dimaksud (`null` jika tidak ada).
`read`	`boolean`	Apakah sudah ditandai dibaca.
`more`	`integer`	Berapa peristiwa lain yang diwakili baris ini, selain yang disebut.
`createdAt`	`integer`	Kapan pertama kali terjadi.
`updatedAt`	`integer`	Kapan 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
}

`Actor`

Siapa yang memicu notifikasi.

Field	Tipe	Arti
`handle`	`string`	Nama pendek.
`name`	`string`	Nama tampilan.

Contoh

{
  "handle": "jon",
  "name": "Jon"
}

`Conversation`

Satu baris kotak masukmu.

Field	Tipe	Arti
`with`	`string`	id akun lainnya: yang diharapkan `/conversations/{with}/messages`.
`handle`	`string`	Nama pendeknya.
`name`	`string`	Nama tampilannya.
`excerpt`	`string`atau null	Awal pesan terakhir (`null` jika tidak ada teks).
`truncated`	`boolean`	Apakah kutipannya dipotong.
`fromMe`	`boolean`	Apakah pesan terakhir milikmu.
`lastMessageId`	`string`	id pesan terakhir.
`unread`	`integer`	Berapa pesannya yang belum kamu baca.
`updatedAt`	`integer`	Kapan 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
}

`Message`

Pesan dalam percakapan.

Field	Tipe	Arti
`id`	`string`	id pesan.
`text`	`string`atau null	Teksnya (`null` untuk pesan yang hanya gambar).
`from`	`string`	id akun yang menulisnya.
`to`	`string`	id akun yang dituju.
`read`	`boolean`	Apakah penerima sudah membacanya.
`media`	`Media[]`	Gambarnya; kosong jika tidak ada.
`replyTo`	`string`atau null	`id` pesan yang dijawab pesan ini (`null` jika tidak menjawab apa pun). Sejak 2.2.
`createdAt`	`integer`	Kapan 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
}

`Created`

Jawaban dari penulisan yang membuat sesuatu.

Field	Tipe	Arti
`id`	`string`	id dari yang dibuat.
`scheduledFor`	`integer`atau null	Kapan muncul, jika penerbitan dijadwalkan (selain itu `null`).
`deleteAt`	`integer`atau null	Kapan menghapus diri, jika diatur (selain itu `null`).

Contoh

{
  "id": "5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1",
  "scheduledFor": null,
  "deleteAt": null
}

`Ok`

Jawaban dari penulisan yang tidak punya apa pun untuk dikembalikan.

Field	Tipe	Arti
`ok`	`boolean`	Selalu `true`.

Contoh

{
  "ok": true
}

Deskripsi yang bisa dibaca mesin

Tabel di balik halaman ini tersedia sebagai OpenAPI di /api/v2/openapi.json.

https://tellmelo.com/api/v2/openapi.json

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.

API

Ringkasan

Mulai cepat

Coba

Kuncimu

Apa yang boleh dilakukan kunci

Yang tidak bisa dilakukan kunci mana pun

Permintaan dan jawaban

Halaman

Hanya yang baru

Batas

Header

Yang kamu kirim

Yang kembali

Saat sesuatu tidak berhasil

Versi

Endpoint

Jalan masuk

GET/api/v2

Contoh permintaan

Jawaban

Postingan

GET/api/v2/posts

Parameter

Contoh permintaan

Jawaban

GET/api/v2/posts/{id}

Parameter

Contoh permintaan

Jawaban

POST/api/v2/posts

Parameter

Contoh permintaan

Jawaban

DELETE/api/v2/posts/{id}

Parameter

Contoh permintaan

Jawaban

Balasan

GET/api/v2/posts/{id}/replies

Parameter

Contoh permintaan

Jawaban

POST/api/v2/posts/{id}/replies

Parameter

Contoh permintaan

Jawaban

Jajak pendapat

POST/api/v2/posts/{id}/vote

Parameter

Contoh permintaan

Jawaban

Profil

GET/api/v2/profiles/{handle}

Parameter

Contoh permintaan

Jawaban

GET/api/v2/profiles/{handle}/posts

Parameter

Contoh permintaan

Jawaban

Grup

GET/api/v2/communities

Parameter

Contoh permintaan

Jawaban

GET/api/v2/communities/{id}

Parameter

Contoh permintaan

Jawaban

GET/api/v2/communities/{id}/posts

Parameter

Contoh permintaan

Jawaban

Jelajahi

GET/api/v2/tags

Parameter

Contoh permintaan

Jawaban

GET/api/v2/search

GET`/api/v2`

GET`/api/v2/posts`

GET`/api/v2/posts/{id}`

POST`/api/v2/posts`

DELETE`/api/v2/posts/{id}`

GET`/api/v2/posts/{id}/replies`

POST`/api/v2/posts/{id}/replies`

POST`/api/v2/posts/{id}/vote`

GET`/api/v2/profiles/{handle}`

GET`/api/v2/profiles/{handle}/posts`

GET`/api/v2/communities`

GET`/api/v2/communities/{id}`

GET`/api/v2/communities/{id}/posts`

GET`/api/v2/tags`

GET`/api/v2/search`

GET`/api/v2/emojis`

GET`/api/v2/me`

GET`/api/v2/feed`

GET`/api/v2/notifications`

POST`/api/v2/notifications/read`

GET`/api/v2/conversations`

GET`/api/v2/conversations/{with}/messages`

POST`/api/v2/conversations/{with}/messages`

POST`/api/v2/conversations/{with}/read`

POST`/api/v2/relations`

`Service`

`RateLimit`

`Post`

`Reply`

`Counts`

`Media`

`Poll`

`PollOption`

`ProfileBrief`

`Profile`

`CommunityBrief`

`Community`

`Tag`

`SearchResult`

`Emoji`

`Notification`

`Actor`

`Conversation`

`Message`

`Created`

`Ok`