Kirim Status

POST /status

Posting story Telegram di profil akun kamu: teks, gambar, atau video. Namanya tetap "status" biar sama kayak Zawa, tapi di Telegram jadinya story yang muncul di bagian atas daftar chat teman-teman kamu.

Detail Endpoint

• Base URL: https://api-zate.azickri.com
• Header: id, session-id, dan Content-Type: application/json
• Syarat: sesi harus lagi nyambung (isConnected: true)

Header

Header	Tipe	Wajib	Keterangan
id	string	Ya	id dari Buat Session.
session-id	string	Ya	sessionId dari Buat Session.

Request Body

Kolom	Tipe	Wajib	Keterangan
type	string	Ya	Tipe story: text, image, atau video.
text	string	Untuk text	Tulisan di story teks. Di tipe image dan video, kolom ini jadi caption (opsional).
privacy	string	Tidak	Siapa yang bisa lihat: contacts (bawaan), everyone, atau close_friends.
image	object	Untuk image	url dan mimetype, sama kayak objek image di Kirim Pesan.
video	object	Untuk video	url, mimetype, duration, dan thumbnail (opsional), sama kayak objek video di Kirim Pesan.

Gimana Story-nya Jadi?

type	Hasilnya
text	Telegram nggak punya story teks, jadi Zate ngegambar tulisanmu warna putih tebal di tengah gambar hijau tua 1080 × 1920. Ukuran hurufnya ngecil sendiri kalau teksnya panjang, dan bagian yang tetap nggak muat bakal kepotong.
image	Gambar dikecilin sampai maksimal 1080 piksel, terus diposting sebagai story foto.
video	Video diposting apa adanya. Kalau thumbnail kosong, Zate ngambil frame pertama videonya.

privacy	Yang bisa lihat
contacts	Semua kontak kamu. Ini nilai bawaan.
everyone	Semua orang.
close_friends	Cuma daftar Close Friends yang kamu atur di Telegram.

Contoh Request

cURL

curl -X POST "https://api-zate.azickri.com/status" \
  -H "id: YOUR_ID" \
  -H "session-id: YOUR_SESSION_ID" \
  -H "Content-Type: application/json" \
  -d '{"type":"text","text":"Sate lagi dibakar, siap diantar! 🍢"}'

Axios

import axios from 'axios';

const response = await axios.post(
  'https://api-zate.azickri.com/status',
  {
    type: 'text',
    text: 'Sate lagi dibakar, siap diantar! 🍢',
  },
  {
    headers: {
      'id': 'YOUR_ID',
      'session-id': 'YOUR_SESSION_ID',
    },
  },
);

console.log(response.data);

Fetch

const response = await fetch('https://api-zate.azickri.com/status', {
  method: 'POST',
  headers: {
    'id': 'YOUR_ID',
    'session-id': 'YOUR_SESSION_ID',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    type: 'text',
    text: 'Sate lagi dibakar, siap diantar! 🍢',
  }),
});

const data = await response.json();
console.log(data);

Contoh Body per Tipe

text

{
  "type": "text",
  "text": "Sate lagi dibakar, siap diantar! 🍢"
}

image

{
  "type": "image",
  "text": "Menu baru minggu ini",
  "privacy": "everyone",
  "image": {
    "url": "https://example.com/menu.jpg",
    "mimetype": "image/jpeg"
  }
}

video

{
  "type": "video",
  "text": "Behind the scene bakar sate",
  "privacy": "close_friends",
  "video": {
    "url": "https://example.com/bakar-sate.mp4",
    "mimetype": "video/mp4",
    "duration": 15
  }
}

Response

200

{
  "statusId": "12"
}

400

// Tipe nggak dikenal
{
  "statusCode": 400,
  "message": "type must be one of the following values: text, image, video"
}

// Privasi nggak dikenal
{
  "statusCode": 400,
  "message": "privacy must be one of the following values: everyone, contacts, close_friends"
}

// Kolom wajib buat tipe itu kosong
{
  "statusCode": 400,
  "message": "text should not be empty"
}

404

{
  "statusCode": 404,
  "message": "session not found"
}

500

// Sesi lagi nggak nyambung
{
  "statusCode": 500,
  "message": "session not connected"
}

// Gambar gagal diproses
{
  "statusCode": 500,
  "message": "error compress image: Input buffer contains unsupported image format"
}

Kolom	Tipe	Keterangan
statusId	string	ID story di profil kamu. Bisa kosong kalau Telegram nggak ngasih ID-nya balik, walaupun story-nya tetap terposting.

Batas story harian

Akun Telegram gratis cuma boleh posting sejumlah story per hari. Kalau udah kena, Telegram nolak story berikutnya dan error-nya diterusin apa adanya. Telegram Premium punya batas yang lebih longgar.