nominal-api 0.1239.0

API bindings for the Nominal platform
Documentation
use conjure_http::endpoint;
/// Channel search over a `DataFrame`, which can expand to multiple locators.
#[conjure_http::conjure_endpoints(
    name = "ChannelSearchService",
    use_legacy_error_serialization
)]
pub trait ChannelSearchService {
    /// Returns the expanded locator topology for a frame plus per-locator delimiter
    /// info.
    #[endpoint(
        method = POST,
        path = "/channels/v1/delimiters",
        name = "getLocatorDelimiters",
        produces = conjure_http::server::StdResponseSerializer
    )]
    fn get_locator_delimiters(
        &self,
        #[auth]
        auth_: conjure_object::BearerToken,
        #[body(deserializer = conjure_http::server::StdRequestDeserializer)]
        request: super::super::super::super::super::objects::scout::channel::api::GetLocatorDelimitersRequest,
    ) -> Result<
        super::super::super::super::super::objects::scout::channel::api::GetLocatorDelimitersResponse,
        conjure_http::private::Error,
    >;
    /// Lazy one-level hierarchical expansion under `parent`. Returns a mix of leaf
    /// channels and prefix nodes, each labelled with the set of locators where
    /// they exist.
    #[endpoint(
        method = POST,
        path = "/channels/v1/browse",
        name = "listChannelChildren",
        produces = conjure_http::server::StdResponseSerializer
    )]
    fn list_channel_children(
        &self,
        #[auth]
        auth_: conjure_object::BearerToken,
        #[body(deserializer = conjure_http::server::StdRequestDeserializer)]
        request: super::super::super::super::super::objects::scout::channel::api::ListChannelChildrenRequest,
    ) -> Result<
        super::super::super::super::super::objects::scout::channel::api::ListChannelChildrenResponse,
        conjure_http::private::Error,
    >;
    /// Flat text search across the frame. Returns matching channels, each labelled
    /// with the set of locators in which they exist.
    #[endpoint(
        method = POST,
        path = "/channels/v1/search",
        name = "searchChannels",
        produces = conjure_http::server::StdResponseSerializer
    )]
    fn search_channels(
        &self,
        #[auth]
        auth_: conjure_object::BearerToken,
        #[body(deserializer = conjure_http::server::StdRequestDeserializer)]
        request: super::super::super::super::super::objects::scout::channel::api::SearchChannelsRequest,
    ) -> Result<
        super::super::super::super::super::objects::scout::channel::api::SearchChannelsResponse,
        conjure_http::private::Error,
    >;
    /// Batched form of `getLocatorDelimiters`.
    #[endpoint(
        method = POST,
        path = "/channels/v1/delimiters/batch",
        name = "batchGetLocatorDelimiters",
        produces = conjure_http::server::StdResponseSerializer
    )]
    fn batch_get_locator_delimiters(
        &self,
        #[auth]
        auth_: conjure_object::BearerToken,
        #[body(deserializer = conjure_http::server::StdRequestDeserializer)]
        request: super::super::super::super::super::objects::scout::channel::api::BatchGetLocatorDelimitersRequest,
    ) -> Result<
        super::super::super::super::super::objects::scout::channel::api::BatchGetLocatorDelimitersResponse,
        conjure_http::private::Error,
    >;
    /// Batched form of `searchChannels`. The channel search is performed across the
    /// union of all entry scopes and so is the limit and top-n selection by relevance.
    #[endpoint(
        method = POST,
        path = "/channels/v1/search/batch",
        name = "batchSearchChannels",
        produces = conjure_http::server::StdResponseSerializer
    )]
    fn batch_search_channels(
        &self,
        #[auth]
        auth_: conjure_object::BearerToken,
        #[body(deserializer = conjure_http::server::StdRequestDeserializer)]
        request: super::super::super::super::super::objects::scout::channel::api::BatchSearchChannelsRequest,
    ) -> Result<
        super::super::super::super::super::objects::scout::channel::api::BatchSearchChannelsResponse,
        conjure_http::private::Error,
    >;
    /// Batched form of `listChannelChildren`. The hierarchical expansion is performed
    /// across the union of all entry scopes for the shared `parent` path.
    #[endpoint(
        method = POST,
        path = "/channels/v1/browse/batch",
        name = "batchListChannelChildren",
        produces = conjure_http::server::StdResponseSerializer
    )]
    fn batch_list_channel_children(
        &self,
        #[auth]
        auth_: conjure_object::BearerToken,
        #[body(deserializer = conjure_http::server::StdRequestDeserializer)]
        request: super::super::super::super::super::objects::scout::channel::api::BatchListChannelChildrenRequest,
    ) -> Result<
        super::super::super::super::super::objects::scout::channel::api::BatchListChannelChildrenResponse,
        conjure_http::private::Error,
    >;
}
/// Channel search over a `DataFrame`, which can expand to multiple locators.
#[conjure_http::conjure_endpoints(
    name = "ChannelSearchService",
    use_legacy_error_serialization
)]
pub trait AsyncChannelSearchService {
    /// Returns the expanded locator topology for a frame plus per-locator delimiter
    /// info.
    #[endpoint(
        method = POST,
        path = "/channels/v1/delimiters",
        name = "getLocatorDelimiters",
        produces = conjure_http::server::StdResponseSerializer
    )]
    async fn get_locator_delimiters(
        &self,
        #[auth]
        auth_: conjure_object::BearerToken,
        #[body(deserializer = conjure_http::server::StdRequestDeserializer)]
        request: super::super::super::super::super::objects::scout::channel::api::GetLocatorDelimitersRequest,
    ) -> Result<
        super::super::super::super::super::objects::scout::channel::api::GetLocatorDelimitersResponse,
        conjure_http::private::Error,
    >;
    /// Lazy one-level hierarchical expansion under `parent`. Returns a mix of leaf
    /// channels and prefix nodes, each labelled with the set of locators where
    /// they exist.
    #[endpoint(
        method = POST,
        path = "/channels/v1/browse",
        name = "listChannelChildren",
        produces = conjure_http::server::StdResponseSerializer
    )]
    async fn list_channel_children(
        &self,
        #[auth]
        auth_: conjure_object::BearerToken,
        #[body(deserializer = conjure_http::server::StdRequestDeserializer)]
        request: super::super::super::super::super::objects::scout::channel::api::ListChannelChildrenRequest,
    ) -> Result<
        super::super::super::super::super::objects::scout::channel::api::ListChannelChildrenResponse,
        conjure_http::private::Error,
    >;
    /// Flat text search across the frame. Returns matching channels, each labelled
    /// with the set of locators in which they exist.
    #[endpoint(
        method = POST,
        path = "/channels/v1/search",
        name = "searchChannels",
        produces = conjure_http::server::StdResponseSerializer
    )]
    async fn search_channels(
        &self,
        #[auth]
        auth_: conjure_object::BearerToken,
        #[body(deserializer = conjure_http::server::StdRequestDeserializer)]
        request: super::super::super::super::super::objects::scout::channel::api::SearchChannelsRequest,
    ) -> Result<
        super::super::super::super::super::objects::scout::channel::api::SearchChannelsResponse,
        conjure_http::private::Error,
    >;
    /// Batched form of `getLocatorDelimiters`.
    #[endpoint(
        method = POST,
        path = "/channels/v1/delimiters/batch",
        name = "batchGetLocatorDelimiters",
        produces = conjure_http::server::StdResponseSerializer
    )]
    async fn batch_get_locator_delimiters(
        &self,
        #[auth]
        auth_: conjure_object::BearerToken,
        #[body(deserializer = conjure_http::server::StdRequestDeserializer)]
        request: super::super::super::super::super::objects::scout::channel::api::BatchGetLocatorDelimitersRequest,
    ) -> Result<
        super::super::super::super::super::objects::scout::channel::api::BatchGetLocatorDelimitersResponse,
        conjure_http::private::Error,
    >;
    /// Batched form of `searchChannels`. The channel search is performed across the
    /// union of all entry scopes and so is the limit and top-n selection by relevance.
    #[endpoint(
        method = POST,
        path = "/channels/v1/search/batch",
        name = "batchSearchChannels",
        produces = conjure_http::server::StdResponseSerializer
    )]
    async fn batch_search_channels(
        &self,
        #[auth]
        auth_: conjure_object::BearerToken,
        #[body(deserializer = conjure_http::server::StdRequestDeserializer)]
        request: super::super::super::super::super::objects::scout::channel::api::BatchSearchChannelsRequest,
    ) -> Result<
        super::super::super::super::super::objects::scout::channel::api::BatchSearchChannelsResponse,
        conjure_http::private::Error,
    >;
    /// Batched form of `listChannelChildren`. The hierarchical expansion is performed
    /// across the union of all entry scopes for the shared `parent` path.
    #[endpoint(
        method = POST,
        path = "/channels/v1/browse/batch",
        name = "batchListChannelChildren",
        produces = conjure_http::server::StdResponseSerializer
    )]
    async fn batch_list_channel_children(
        &self,
        #[auth]
        auth_: conjure_object::BearerToken,
        #[body(deserializer = conjure_http::server::StdRequestDeserializer)]
        request: super::super::super::super::super::objects::scout::channel::api::BatchListChannelChildrenRequest,
    ) -> Result<
        super::super::super::super::super::objects::scout::channel::api::BatchListChannelChildrenResponse,
        conjure_http::private::Error,
    >;
}
/// Channel search over a `DataFrame`, which can expand to multiple locators.
#[conjure_http::conjure_endpoints(
    name = "ChannelSearchService",
    use_legacy_error_serialization,
    local
)]
pub trait LocalAsyncChannelSearchService {
    /// Returns the expanded locator topology for a frame plus per-locator delimiter
    /// info.
    #[endpoint(
        method = POST,
        path = "/channels/v1/delimiters",
        name = "getLocatorDelimiters",
        produces = conjure_http::server::StdResponseSerializer
    )]
    async fn get_locator_delimiters(
        &self,
        #[auth]
        auth_: conjure_object::BearerToken,
        #[body(deserializer = conjure_http::server::StdRequestDeserializer)]
        request: super::super::super::super::super::objects::scout::channel::api::GetLocatorDelimitersRequest,
    ) -> Result<
        super::super::super::super::super::objects::scout::channel::api::GetLocatorDelimitersResponse,
        conjure_http::private::Error,
    >;
    /// Lazy one-level hierarchical expansion under `parent`. Returns a mix of leaf
    /// channels and prefix nodes, each labelled with the set of locators where
    /// they exist.
    #[endpoint(
        method = POST,
        path = "/channels/v1/browse",
        name = "listChannelChildren",
        produces = conjure_http::server::StdResponseSerializer
    )]
    async fn list_channel_children(
        &self,
        #[auth]
        auth_: conjure_object::BearerToken,
        #[body(deserializer = conjure_http::server::StdRequestDeserializer)]
        request: super::super::super::super::super::objects::scout::channel::api::ListChannelChildrenRequest,
    ) -> Result<
        super::super::super::super::super::objects::scout::channel::api::ListChannelChildrenResponse,
        conjure_http::private::Error,
    >;
    /// Flat text search across the frame. Returns matching channels, each labelled
    /// with the set of locators in which they exist.
    #[endpoint(
        method = POST,
        path = "/channels/v1/search",
        name = "searchChannels",
        produces = conjure_http::server::StdResponseSerializer
    )]
    async fn search_channels(
        &self,
        #[auth]
        auth_: conjure_object::BearerToken,
        #[body(deserializer = conjure_http::server::StdRequestDeserializer)]
        request: super::super::super::super::super::objects::scout::channel::api::SearchChannelsRequest,
    ) -> Result<
        super::super::super::super::super::objects::scout::channel::api::SearchChannelsResponse,
        conjure_http::private::Error,
    >;
    /// Batched form of `getLocatorDelimiters`.
    #[endpoint(
        method = POST,
        path = "/channels/v1/delimiters/batch",
        name = "batchGetLocatorDelimiters",
        produces = conjure_http::server::StdResponseSerializer
    )]
    async fn batch_get_locator_delimiters(
        &self,
        #[auth]
        auth_: conjure_object::BearerToken,
        #[body(deserializer = conjure_http::server::StdRequestDeserializer)]
        request: super::super::super::super::super::objects::scout::channel::api::BatchGetLocatorDelimitersRequest,
    ) -> Result<
        super::super::super::super::super::objects::scout::channel::api::BatchGetLocatorDelimitersResponse,
        conjure_http::private::Error,
    >;
    /// Batched form of `searchChannels`. The channel search is performed across the
    /// union of all entry scopes and so is the limit and top-n selection by relevance.
    #[endpoint(
        method = POST,
        path = "/channels/v1/search/batch",
        name = "batchSearchChannels",
        produces = conjure_http::server::StdResponseSerializer
    )]
    async fn batch_search_channels(
        &self,
        #[auth]
        auth_: conjure_object::BearerToken,
        #[body(deserializer = conjure_http::server::StdRequestDeserializer)]
        request: super::super::super::super::super::objects::scout::channel::api::BatchSearchChannelsRequest,
    ) -> Result<
        super::super::super::super::super::objects::scout::channel::api::BatchSearchChannelsResponse,
        conjure_http::private::Error,
    >;
    /// Batched form of `listChannelChildren`. The hierarchical expansion is performed
    /// across the union of all entry scopes for the shared `parent` path.
    #[endpoint(
        method = POST,
        path = "/channels/v1/browse/batch",
        name = "batchListChannelChildren",
        produces = conjure_http::server::StdResponseSerializer
    )]
    async fn batch_list_channel_children(
        &self,
        #[auth]
        auth_: conjure_object::BearerToken,
        #[body(deserializer = conjure_http::server::StdRequestDeserializer)]
        request: super::super::super::super::super::objects::scout::channel::api::BatchListChannelChildrenRequest,
    ) -> Result<
        super::super::super::super::super::objects::scout::channel::api::BatchListChannelChildrenResponse,
        conjure_http::private::Error,
    >;
}