К основному содержимому

Как работать с тестовой средой для API-интеграции: песочница Островок B2B

Обновлено более месяца назад

Что такое песочница API от Островок B2B?

Песочница API — это безопасная симуляционная среда, которая отражает рабочую производственную систему. Она позволяет разработчикам выполнять API-запросы так же, как в реальных условиях, но с использованием тестовых объектов и конечных точек вместо реальных данных.

Это означает, что вы можете безопасно тестировать поиск, проверку доступности, бронирование и отмену без реальных транзакций и влияния на данные клиентов. Каждый пользователь песочницы получает специальную учётную запись, которая даёт доступ к условным объектам размещения и позволяет моделировать реальные сценарии, например, изменение цен, налогов или вариантов питания.

Обратите внимание: доступ предоставляется новым партнёрам, начавшим интеграцию в четвёртом квартале 2025 года и позже.

Преимущества песочницы для партнёров и разработчиков

Моделирование реальных процессов: тестовая среда позволяет безопасно экспериментировать с поиском жилья, проверкой доступности, бронированием и отменой без влияния на реальные данные.

Проведение экспериментов с тестовыми объектами: готовые примеры помогают проверить работу системы в разных сценариях — от изменения цен, налогов и вариантов питания до обновления доступности номеров.

Повышение стабильности: вы сможете воспроизвести типичные ошибки и понять, как их устранить, чтобы обеспечить надёжную и стабильную интеграцию.

Ускорение разработки: работа идёт быстрее благодаря точной документации, передовым практикам и рекомендациям по сертификации API.

4 шага для начала работы

1. Запросите ключ

Свяжитесь с вашим менеджером, чтобы получить учётные данные песочницы.

Обратите внимание: рабочие учётные данные не могут использоваться в тестовой среде.

2. Установите конечную точку

Укажите в коде адрес хоста песочницы: https://api-sandbox.worldota.net

3. Следуйте инструкциям

Реализуйте интеграцию в соответствии с официальной документацией. Воспользуйтесь руководством по интеграции и сертификации песочницы, а также лучшими практиками для песочницы API, чтобы обеспечить корректную настройку.

Обратите внимание: документы доступны на английском языке.

Sandbox Integration and Certification Guidelines

Best Practices for Sandbox API

4. Тестируйте на реалистичных сценариях

Готово! Вы получили доступ к песочнице — разрабатывайте и тестируйте новые решения, проверяйте работоспособность каждого API-запроса.

Оптимизация работы с песочницей

Песочница воспроизводит реальную рабочую среду, но, чтобы обеспечить безопасность тестирования, некоторые её возможности намеренно упрощены:

  • отключены банковские транзакции и платежи картой;

  • не поддерживаются платежи с технологией 3D Secure;

  • предустановлены лимиты результатов и тестовые данные (обычно в долларах США или евро).

Ограничения обеспечивают надёжность и стабильность системы, позволяя вам полностью протестировать логику, рабочие потоки и обработку ошибок.

Что будет после тестирования

Команда запуска API проверит вашу интеграцию, предоставит обратную связь и сертифицирует продукт для использования в реальных условиях.

Каждый продукт — API, веб-сайт или мобильное приложение — требует отдельной сертификации, которая обычно занимает 14–30 дней.

Нашли ответ на свой вопрос?