EN IT

Quickstart

Questa guida ti porta da zero alla tua prima chiamata API in meno di 5 minuti.

Prerequisiti

  • Un account Contit su app.contit.cloud
  • Un workspace con almeno un Content Type
  • Credenziali API (Client ID + Secret oppure una API Key)

Step 1 — Ottieni un access token

curl -X POST https://idp.contit.cloud/connect/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials&client_id=TUO_CLIENT_ID&client_secret=TUO_CLIENT_SECRET"

Copia il valore di access_token dalla risposta.

Step 2 — Elenca i tuoi content type

curl https://api.contit.cloud/content-types \
  -H "Authorization: Bearer IL_TUO_TOKEN"

Ricevi un array di definizioni di Content Type. Prendi nota del campo id — è la chiave che userai in tutte le operazioni sui contenuti.

Step 3 — Recupera i contenuti

Sostituisci mioContentType con una chiave dal passo precedente:

curl -X POST https://api.contit.cloud/v2/contents/mioContentType \
  -H "Authorization: Bearer IL_TUO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"page": 1, "pageSize": 10}'

Step 4 — Crea un contenuto (V2)

curl -X PUT https://api.contit.cloud/v2/contents/mioContentType \
  -H "Authorization: Bearer IL_TUO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "fields": {
      "titolo": "Il mio primo contenuto",
      "corpo": "Ciao dal Contit API!"
    }
  }'

La risposta include il content item completo con il suo id assegnato.

Usando l'.NET SDK

Se usi .NET, installa l'SDK ufficiale:

dotnet add package ContitApi

var client = new ContitClient(
    new ClientContitConfiguration("TUO_CLIENT_ID", "TUO_CLIENT_SECRET"));

// Recupera contenuti
var result = await client.Content.Get<MioModello>("mioContentType",
    new ContentsRequest { Page = 1, PageSize = 10 });

// Crea un contenuto
await client.Content.AddOrUpdate("mioContentType", new ContentModel
{
    Fields = [
        new TextContentField { Key = "titolo", Value = "Il mio primo contenuto" }
    ]
});

Prossimi passi