Vivos et Securus: Aliquam a Aliquam erat volutpat Sharepoint CETERA

There are a lot of resources around that show how to do this, but I couldn’t find a comprehensive go-to link, so here we are.

You can create a SharePoint site using the REST API.  Here’s a fully baked example:

<!--
    SiteRequestForm.html: Collect information and create a site for the user.
-->

<centrum>
<mensamque>
    <tr>
        <td>Site Name:</td>
        <td><input typus="text" nomen="SiteName" id="SiteName" /></td>
    </tr>
    <tr>
        <td colspan="2">
            <input typus="submit" id="CreateSiteButton" valor="Create the Site" />
        </td>
    </tr>
</mensamque>
</centrum>

<script msgstr="../Plugins/jquery-1.11.0.min.js"></script>

<script>
var CreateSiteLogicContainer = {

    createSiteData: {
            "parameters": {
                __metadata: { "type": "SP.WebInfoCreationInformation" },
                Url: "Paultest1",
                Title: "Paultest1",
                Descriptio: "rest-created web by Paul!",
                Linguam: 1033,
                WebTemplate: "sts",
                UseUniquePermissions: falsum
            }
    },

    createSite: munus () {

        jQuery.support.cors = verum;

        CreateSiteLogicContainer.createSiteData.parameters.Url = $("#SiteName").Val();
        
        $.ajax({
            url: "https://bigapplesharepoint.sharepoint.com/NBAIADev/_api/web/webinfos/add",
            methodo: "POST",

            headers: {
                "Accept": "application/json; odata=verbose",
                "content-type": "application/json;odata=verbose",
                "X-RequestDigest": $("#__REQUESTDIGEST").Val()
            },

            Notitia: JSON.stringify(CreateSiteLogicContainer.createSiteData),

            success: munus () { alert("success"); },
            error: munus () { alert("error"); }

        });
    },

    wireUpForm: munus () {
        $("#CreateSiteButton").click(munus () {
            alert("About to try and create the site.");
            CreateSiteLogicContainer.createSite();
        });
    }


}

CreateSiteLogicContainer.wireUpForm();

</script>

When successful, you get a JSON packet in response like this:

image

My key thoughts and learnings from this include:

  • This approach uses jQuery.  In meam, my jQuery library is located in “../plugins.”  You’ll want to change that to point to your favorite JQ location.
  • You can copy and paste that whole snippet into a Content Editor Web Part on a page and it should work just fine.  You’ll want to change the end point of the API call and make sure you reference JQ correctly.
  • The URL is relative to your API’s endpoint.  In meam, it’s creating sub-sites underneath https://bigapplesharepoint.com
  • You don’t need to provide a content-length. Some blog posts and MSDN document implies that you do, but happened for me automatically, which I assume is being handled by the $.ajax call itself.
  • This line is required in order to avoid a “forbidden” response: "X-RequestDigest": $("#__REQUESTDIGEST").Val().  There are other ways to do it, but this is pretty nice.  I have lost the link to blog that provided this shortcut.  H/T to you, mysterious blogger!

Good luck and hope this helps someone out.

</finem>

undefinedScribet ad mea blog.

Sequi me in Twitter ad http://www.twitter.com/pagalvin

Aliquam

Tua inscriptio electronica non editis. Velit sunt insignis *