Getting started with Contensis using the .Net Management API

Setting up your environment 🌳

BASH

1
2

mkdir contensis-dot-net
cd contensis-dot-net

Using a .Net template 🏗️

BASH

1dotnet new console

Creating our application 💻

using System;
using Zengenti.Contensis.Management;
using DotNetEnv;

namespace CreateEntries
{
    class Program
    {
        static void Main()
        {

        }
    }
}

1
2

dotnet add package Zengenti.Contensis.Management
dotnet add package DotNetEnv

Setting up the client 🧰

        // Load the .env file into environment variables
        DotNetEnv.Env.Load();

        // Client Initlisation
        var client = ManagementClient.Create(
            rootUrl: string.Format("https://api-{0}.cloud.contensis.com", DotNetEnv.Env.GetString("ALIAS")),
            clientId: DotNetEnv.Env.GetString("CLIENT_ID"),
            sharedSecret: DotNetEnv.Env.GetString("CLIENT_SECRET")
        );

Creating our API key 🔑

The Create a new API key screen in Contensis.

1
2
3

CLIENT_ID= {your client ID}

CLIENT_SECRET= {your shared secret}

Configuring your PROJECT_API_ID and ALIAS ⚙️

The General Settings screen in Contensis with the API Name field highlighted.

1
2
3

PROJECT_API_ID= {yourProjectId}

ALIAS= {yourAlias}

Setting up API key roles and permissions 🤝

Creating our first Content Type 🎨

The Create new content type window in Contensis.

Editing a field name in the Contensis content type editor.

Creating our first Entry 📝

1
2

// Retrieve Project   
var myProject = client.Projects.Get(DotNetEnv.Env.GetString("PROJECT_API_ID"));

1
2

// Create Entry
var entryBook = myProject.Entries.New("book");

1
2

 // Set Fields
entryBook.Set("bookTitle", "How not to kill your houseplants 🌱");

// Save Entry
        try 
        {
            entryBook.Save();
            Console.WriteLine("Successfully Created Entry!");
        } 
        catch (Exception ex)
        {
            Console.WriteLine("An unexpected error occurred: " + ex.Message);
        }

using System;
using Zengenti.Contensis.Management;
using DotNetEnv;


namespace CreateEntries 
{
    class Program 
    {
        static void Main() 
        {

        // Load the .env file into environment variables
        DotNetEnv.Env.Load();

        // Client Initlisation
        var client = ManagementClient.Create(
            rootUrl: string.Format("https://api-{0}.cloud.contensis.com", DotNetEnv.Env.GetString("ALIAS")),
            clientId: DotNetEnv.Env.GetString("CLIENT_ID"),
            sharedSecret: DotNetEnv.Env.GetString("CLIENT_SECRET")
        );

        // Retrieve Project   
        var myProject = client.Projects.Get(DotNetEnv.Env.GetString("PROJECT_API_ID"));

        // Create Entry
        var entryBook = myProject.Entries.New("book");
        // Set Fields
        entryBook.Set("bookTitle", "How not to kill your houseplants 🌱");
        // Save Entry
        try 
        {
            entryBook.Save();
            Console.WriteLine("Successfully Created Entry!");
        } 
        catch (Exception ex)
        {
            Console.WriteLine("An unexpected error occurred: " + ex.Message);
        }

    }
}
}

Still need help?

New support request