API ZeeDo

Buat kunci di Pengaturan → API & webhook (pemilik mengonfirmasi identitasnya lebih dulu), lalu panggil API dengan kunci itu sebagai bearer token. URL dasarnya https://api.zeedo.cloud/v1.

curl https://api.zeedo.cloud/v1/me \
  -H "Authorization: Bearer <kunci API Anda>"

• Kunci milik organisasi, memiliki cakupan — read, write, atau admin — dan bisa dibatasi ke satu ruang kerja.
• Body JSON, kolom snake_case, waktu dalam ISO 8601 UTC.
• Error berupa dokumen masalah RFC 9457: type, title, status, detail dan, untuk kolom yang ditolak, errors[] dengan JSON pointer.
• Daftar dibagi per halaman dengan limit (paling banyak 200) dan next_cursor.
• Kirim header Idempotency-Key di setiap POST: pengulangan dalam 24 jam mendapat jawaban yang sama dengan yang pertama.
• 600 permintaan per menit dan 10 stream terbuka per kunci, dengan header RateLimit-*.

Organisasi mendaftarkan satu endpoint (Pengaturan → API & webhook, atau POST /webhooks) dan memilih event-nya. Setiap event berupa POST JSON berisi id, jenis, dan stempel waktu — tidak pernah nama, email, atau alamat IP seseorang, yang Anda baca kembali lewat API dengan kunci.

{
  "id": "evt_eu_01J9ZQ3M7X5V2K8R4T6Y1N0PBA",
  "type": "run.completed",
  "version": 1,
  "occurred_at": "2026-09-27T10:02:31.000Z",
  "org_id": "org_eu_01J9ZQ1C4H8D6F2W5S7K3M9QXE",
  "data": {
    "run_id": "run_eu_01J9ZQ2V8N4B6C1X3Z5Q7W9ERT",
    "bot_id": "bot_eu_01J9ZQ2A3S5D7F9G1H3J5K7L9M"
  }
}

Setiap pengiriman ditandatangani: ZeeDo-Signature: t=<detik unix>,v1=<tanda tangan>, dengan tanda tangan berupa HMAC-SHA256 heksadesimal dari <t>.<body mentah> yang dikunci dengan secret endpoint Anda. Setelah Anda merotasi secret, secret sebelumnya ikut menandatangani selama 24 jam, sebagai v1 kedua. Tolak tanda tangan yang berumur lebih dari 5 menit.

import { createHmac, timingSafeEqual } from 'node:crypto';

// header: nilai ZeeDo-Signature; body: body permintaan mentah, sebelum parsing JSON apa pun
export function verified(header, body, secret) {
  const parts = header.split(',');
  const t = parts.find((p) => p.startsWith('t='))?.slice(2);
  if (!t || Math.abs(Date.now() / 1000 - Number(t)) > 300) return false;
  const expected = createHmac('sha256', secret).update(`${t}.${body}`).digest('hex');
  return parts.filter((p) => p.startsWith('v1=')).some((p) =>
    p.length === expected.length + 3 && timingSafeEqual(Buffer.from(p.slice(3)), Buffer.from(expected)));
}

• Jawab dengan 2xx apa pun dalam 10 detik. Selain itu — error, redirect, atau tidak ada jawaban — dicoba ulang dengan jeda yang makin lama selama 24 jam; setelah itu pengiriman menjadi dead letter, disimpan 7 hari dan bisa dikirim ulang dari Pengaturan.
• Pengiriman terjadi minimal sekali dan tanpa urutan tertentu: lewati id yang sudah Anda tangani.
• Permintaan juga membawa ZeeDo-Event-Id, ZeeDo-Event-Type, dan ZeeDo-Delivery-Id. Endpoint memakai https di port 443 pada nama host publik.
• Event: alert.fired, approval.decided, approval.requested, billing.service_state_changed, bot.state_changed, budget.threshold, connection.created, connection.error, consent.recorded, memory.note_created, policy.updated, run.cancelled, run.completed, run.failed, run.parked, task.completed, dan task.created.
• Untuk memeriksa endpoint Anda, tekan Kirim uji coba di Pengaturan → API & webhook: satu pengiriman bertipe webhook.test dengan data kosong, ditandatangani seperti yang lain dan dikirim apa pun event yang Anda pilih. Paling banyak sekali per menit.