اربط أنظمتك بتجربة

curl "https://tajribah.org/api/v1/products?limit=20" \
  -H "Authorization: Bearer tjr_…"

حتى 600 طلب في الدقيقة لكل مفتاح؛ كل جواب يحمل x-ratelimit-remaining. الأخطاء بصيغة application/problem+json، وتجاوز الحد 429 مع retry-after.

• product.created — أُضيف منتج في تجربة.
• product.updated — عُدّل منتج في تجربة.
• product.deleted — حُذف منتج (يحمل معرّفه فقط).
• model.published — نُشر نموذج ثلاثي الأبعاد.
• ai_job.finished — انتهى عمل للذكاء الاصطناعي: اكتمل أو تعذّر أو أُلغي.

كل رسالة موقّعة في الترويسة tajribah-signature. تحقّق منها قبل أن تثق بها — بهذه الدالة في Node.js مثلًا:

const { createHmac, timingSafeEqual } = require('node:crypto');

// header: the tajribah-signature header; rawBody: the body exactly as it arrived.
function verify(secret, header, rawBody, toleranceSeconds = 300) {
  const parts = Object.fromEntries(header.split(',').map((part) => part.split('=')));
  const t = Number(parts.t);
  if (!t || Math.abs(Date.now() / 1000 - t) > toleranceSeconds) return false;
  const expected = createHmac('sha256', secret).update(t + '.' + rawBody).digest();
  const given = Buffer.from(parts.v1 || '', 'hex');
  return given.length === expected.length && timingSafeEqual(given, expected);
}

أجب بـ 2xx خلال 10 ثوانٍ. غير ذلك نعيد المحاولة نحو 21 ساعة، ولا نتبع التحويلات. المعرّف id واحد في كل إعادة: تجاهل المكرر. العنوان الذي يفشل مرارًا يُوقَف ويُخبَر المتجر.