API B2C Commerce (также известный как Salesforce Commerce API или SCAPI) представляет собой набор RESTful API, предназначенных для взаимодействия с экземплярами B2C Commerce. Он предоставляет разработчикам возможность создавать кастомизированные решения электронной коммерции, включая магазины, административные инструменты и интеграции с внешними системами. SCAPI был представлен в 2020 году как современная альтернатива ранее существовавшему Open Commerce API (OCAPI), ориентированный на архитектуру headless и гибкость в разработке.
SCAPI разделён на две основные группы API: Shopper API и SCAPI Admin API. Shopper API ориентирован на взаимодействие с конечными пользователями, включая функции просмотра товаров, управление корзиной и оформление заказов. SCAPI Admin API предназначен для административных задач, таких как управление каталогами, заказами, инвентаризацией и клиентами. Обе группы API используют различные механизмы аутентификации и авторизации, обеспечивая безопасность и соответствие требованиям.
- Shopper API: Предназначен для клиентских приложений, поддерживает анонимных пользователей и различные методы аутентификации, включая OAuth 2.1. Включает в себя такие функциональные блоки, как Shopper Baskets, Shopper Customers, Shopper Orders и Shopper Products.
- SCAPI Admin API: Ориентирован на административные задачи, такие как управление каталогами, заказами, инвентаризацией и клиентами. Использует Account Manager для аутентификации и авторизации, поддерживает только авторизованных пользователей.
- Shopper Login and API Access Service (SLAS): Сервис аутентификации, основанный на стандарте OAuth 2.1, предоставляет токены доступа для Shopper API, поддерживает различные провайдеры идентификации и возможности единого входа.
- Custom APIs: Возможность создания собственных REST API, расширяющих функциональность SCAPI, включая поддержку аутентификации, авторизации и серверного кэширования.
- Shopper Context API: Предоставляет персонализированный опыт покупок, позволяя устанавливать контекст покупателя (например, тип устройства, идентификатор магазина) и получать персонализированные предложения, методы оплаты и доставки.
- Salesforce Commerce SDKs: Наборы инструментов для различных языков программирования, включая JavaScript (Node.js и Isomorphic), облегчающие взаимодействие с SCAPI и ускоряющие разработку.
- Rate Limiting и Load Shedding: Механизмы управления нагрузкой, обеспечивающие стабильную работу API при высоких нагрузках, включая отказ в обслуживании запросов при превышении порогов загрузки сервера.
- Поддержка версий и обновлений: SCAPI регулярно обновляется с добавлением новых функций, улучшений производительности и исправлений ошибок, с учётом политики изменения и графика развертывания.