internal package Foswiki::UI::Rest

See PublishedAPI for packages intended to be used by Plugin and Contrib authors, or browse all packages.
See also Developing plugins, Developer's Bible, Technical Overview

    On this page:

    internal package Foswiki::UI::Rest

    UI delegate for REST interface

    StaticMethod registerRESTHandler( $subject, $verb, \&fn, %options )

    Adds a function to the dispatch table of the REST interface for a given subject. See CommandAndCGIScripts#rest for more info.

    • $subject - The subject under which the function will be registered.
    • $verb - The verb under which the function will be registered.
    • \&fn - Reference to the function.

    The handler function must be of the form: 
    sub handler(\%session, $subject, $verb) -> $text
    where:
    • \%session - a reference to the Foswiki session object (may be ignored)
    • $subject - The invoked subject (may be ignored)
    • $verb - The invoked verb (may be ignored)

    Additional options are set in the %options hash. These options are important to ensuring that requests to your handler can't be used in cross-scripting attacks, or used for phishing.
    • authenticate - use this boolean option to require authentication for the handler. If this is set, then an authenticated session must be in place or the REST call will be rejected with a 401 (Unauthorized) status code. By default, rest handlers do not require authentication.
    • validate - use this boolean option to require validation of any requests made to this handler. By default, requests made to REST handlers are not validated.
    • http_allow use this option to specify the HTTP methods that can be used to invoke the handler.


    Edit • Attach • Print version • History: r1 • Backlinks • View wiki text • More topic actions