زی‌هاب/راهنمای اتصال

راهنمای اتصال

سه قدم تا اولین فراخوانی در محیط آزمایشی.

کلید بسازید

از پنل، بخش کلیدها، یک کلید آزمایشی بسازید. مقدار کامل فقط یک بار نمایش داده می‌شود.

کلید را امن نگه دارید

کلید را در متغیر محیطی سرور بگذارید؛ نه در نشانی، گزارش یا حافظهٔ مرورگر.

هر عملیات، یک Idempotency-Key

برای هر عملیات منطقی یک کلید یکتا بفرستید تا تکرار شبکه دوباره کسر نشود.

cURL

curl -X POST http://localhost:4000/v1/services/mobile-national-match/execute \
  -H "Authorization: Bearer $ZEEHUB_KEY" \
  -H "Idempotency-Key: example-key-001" \
  -H "Content-Type: application/json" \
  -d '{"input":{"mobile":"09123334455","nationalId":"0499370899"}}'

Node.js

const response = await fetch("http://localhost:4000/v1/services/iban-inquiry/execute", {
  method: "POST",
  headers: {
    authorization: `Bearer ${process.env.ZEEHUB_KEY}`,
    "idempotency-key": crypto.randomUUID(),
    "content-type": "application/json",
  },
  body: JSON.stringify({ input: { iban: "IR771700000000000000000001" } }),
});

کلید sandbox همیشه پاسخ آزمایشی با برچسب mock می‌دهد. کلید production تا تأیید حساب و تنظیم واقعی تأمین‌کننده کار نمی‌کند.