Пілотний тиждень API: ключі та вебхуки на живому трафіку

Пілотний тиждень API: ключі та вебхуки на живому трафіку.

Перехід API-ключів на продакшн-трафік

Перехід від тестування до реальних відправок вимагає чіткого розмежування доступів. Під час пілотного тижня замініть тестові ключі на продакшн-токени з обмеженими правами. Продакшн-ключі мають дозволяти лише відправку SMS чи прийом вебхуків. Для активації номерів IOSOR застосовує JIT-механізм, де резервування створює тимчасове утримання балансу до остаточного закріплення номера.

Валідація підписаних вебхуків на живому потоці

Прийом DLR та вхідних повідомлень потребує криптографічної перевірки. Кожен payload на ваш callback URL містить підпис, розрахований за допомогою секретного ключа. Перевіряйте часовий штамп через підпис webhook і вікно replay для відхилення застарілих запитів. Узгодьте свій обробник із документом Контракт webhook перед першим надсиланням для швидкого повернення HTTP 200.

Ідемпотентність запитів та утримання балансу

Сетеві збої можуть спричинити повторні HTTP-запити. Передача заголовка Idempotency-Key гарантує, що дубльовані запити не призведуть до подвійних списань чи повторної відправки SMS. Перегляньте матеріал ідемпотентність, retry і гроші, щоб дізнатися про захист коштів. Платформа виконує тимчасове утримання балансу, підтверджуючи списання після успішного приймання запиту.

Обработка DLR-сповіщень та повторні спроби

Статуси доставки можуть надходити із затримками. Забезпечте асинхронну обробку подій через внутрішню чергу. Якщо ваш ендпоінт повертає помилку, система запускає повторні спроби з експоненційним інтервалом. Використовуйте UUID повідомлення для запобігання дублюванню DLR.

Фінансові ліміти та розширення пілотного тижня

Пілотний тиждень проходить у рамках прозорих фінансових правил. Активація починається з ліміту USD 20 prepaid floor, що гарантує наявність резерву на балансі. Коли обсяг зростає і ви проходите soft review near USD 1,000/month, ліміти автоматично підвищуються без переривання трафіку.

Розпочніть з IOSOR

Випустіть ключ із областю production — не sandbox-токен — і спрямуйте callback на підписаний webhook URL, яким володієте. Надішліть один OTP або алерт з Idempotency-Key. Переконайтеся, що prepaid-hold, debit і DLR сіли на той самий намір. Значок Live без окремого ключа й перевіреного підпису досі setup.

Підсумок IOSOR

Робіть: перший живий тиждень ведіть на production-ключі, підписаному webhook і одному prepaid-hold, який видно в ledger.

Не робіть: тягнути sandbox-токен на живий трафік і приймати непідписаний callback як «для пілота зійде».