pckg_pass_codes
Директива `pckg_pass_codes` настраивает конкретные коды ответов для API обработки медиа Kaltura.
Описание
Директива pckg_pass_codes в Kaltura Media Framework Common NGINX Module используется для указания списка HTTP кодов ответа, которые сервер NGINX должен передавать клиенту при обработке запросов к API, связанных с медиа Kaltura. Это особенно полезно для указания статуса различных задач по обработке медиа и предоставления информативной обратной связи клиентам, особенно в распределённой системе, где может происходить взаимодействие нескольких медиа-компонентов. Директива принимает одно или несколько целых значений, соответствующих HTTP статусам, что обеспечивает гибкость в ответах, отправляемых клиентам.
Эта директива может быть размещена в контексте http, server или location в конфигурации NGINX, то есть её можно настроить глобально для всех запросов или локально для отдельных контекстов в зависимости от настроек обработки медиа на сервере. После определения NGINX будет отслеживать входящие запросы к назначенным маршрутам, которые обращаются к API Kaltura, и использовать указанные коды ответов в механизме формирования ответа, что важно для приложений, зависящих от корректного сигнализирования результатов обработки медиа.
При использовании pckg_pass_codes важно убедиться, что используются допустимые HTTP статусы, определённые в спецификациях HTTP. Неправильное использование или указание неопределённых кодов может привести к непредвиденному поведению, например к возврату неизвестных типов ответов или ошибкам на стороне клиента.
Пример конфига
http {
server {
location /api {
pckg_pass_codes 200 404 500;
}
}
}Убедитесь, что указанные коды являются допустимыми HTTP status codes, чтобы избежать ошибок на стороне клиента.
Неподходящие status codes могут вызвать путаницу у клиентских приложений, ожидающих конкретных ответов.
Конфигурации кодов следует тщательно тестировать, особенно в условиях высокой нагрузки, чтобы обеспечить отзывчивость.