ابنِ فوق ملاحظات
اجتماعاتك أنت.

curl -X POST https://api.reline.so/api/zapier/notes \
  -H "Authorization: Bearer rlk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"title":"Kickoff call","description":"Agenda + owners"}'

# 201 -> { "id": "...", "title": "Kickoff call", "url": "https://..." }

كائن الملاحظة

الشكل نفسه يعود من نقطة نهاية الملاحظات ويصل داخل حمولة كل خطاف ويب، فما تربطه مرة واحدة ينطبق في كل مكان. أما حقول الملخّص والمهام فترافق الأحداث التي تحملها.

{
  "id": "j57...",
  "noteId": "j57...",
  "title": "Kickoff call",
  "url": "https://app.reline.so/acme/notes/j57...",
  "folderId": "k21..." | null,
  "folderName": "Clients" | null,
  "isArchived": false,
  "createdAt": 1788302403777,
  "updatedAt": 1788302911204
}

التسليم

ترافق المتنَ ثلاث ترويسات: اسم الحدث، ومعرّف تسليم فريد، والتوقيع.

POST https://your-endpoint.example.com
X-Reline-Event:     note.summarized
X-Reline-Delivery:  9f3c...
X-Reline-Signature: t=1788302403,v1=6b8a...

{
  "id": "9f3c...",
  "event": "note.summarized",
  "occurredAt": 1788302403777,
  "workspace": { "id": "w1...", "slug": "acme", "name": "Acme" },
  "data": { "noteId": "j57...", "summary": "# Kickoff\n..." }
}

التحقق من تسليم

التوقيع هو HMAC-SHA256 يُحسب على الطابع الزمني والمتن الخام موصولين بنقطة، بمفتاح التوقيع السري الذي ظهر عند إنشاء الاشتراك. احسبه على البايتات كما وصلتك قبل أي تحليل لـ JSON، وقارن في زمن ثابت.

import crypto from 'node:crypto'

// `raw` is the request body as received — verify BEFORE JSON.parse.
function verify(raw: string, header: string, secret: string): boolean {
  const parts = Object.fromEntries(header.split(',').map((p) => p.split('=')))
  const expected = crypto
    .createHmac('sha256', secret)
    .update(`${parts.t}.${raw}`)
    .digest('hex')
  if (typeof parts.v1 !== 'string' || parts.v1.length !== expected.length) return false
  return crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(parts.v1))
}