Importar JSON

O importador do Acachy CMS permite criar ou atualizar Content Types e Entries a partir de JSON.

Importar Content Types

Content Types definem a estrutura dos conteúdos.

[
  {
    "name": "Posts",
    "slug": "posts",
    "fields": [
      { "name": "name", "type": "text", "required": true },
      { "name": "description", "type": "text", "required": true },
      { "name": "body", "type": "markdown", "required": true },
      { "name": "image", "type": "image", "required": false },
      { "name": "category", "type": "text", "required": true },
      { "name": "slug", "type": "text", "required": true },
      { "name": "publishedAt", "type": "date", "required": true }
    ]
  }
]

Tipos suportados: text, markdown, date, boolean, select, repeatable, relation, image e file.

Importar Entries

Cada entry referencia um content type por contentTypeSlug ou contentTypeId.

[
  {
    "contentTypeSlug": "posts",
    "data": {
      "name": "Meu primeiro post",
      "description": "Resumo curto",
      "body": "# Olá mundo",
      "image": "https://example.com/image.jpg",
      "category": "News",
      "slug": "meu-primeiro-post",
      "publishedAt": "2026-06-22"
    },
    "status": "published"
  }
]

Relações

Para campos relation, informe o slug da entry relacionada. O importador resolve esse valor para o ID da entry relacionada.

[
  {
    "contentTypeSlug": "experience-projects",
    "data": {
      "name": "Conta de Novo",
      "description": "Aplicativo mobile",
      "image": "https://example.com/app.png",
      "website": "https://example.com",
      "experience": "multiverso-das-letras",
      "slug": "conta-de-novo"
    },
    "status": "published"
  }
]

Importe primeiro as entries que serão usadas como alvo da relação. Depois importe as entries dependentes.

Reimportação Segura

Você pode importar o mesmo JSON mais de uma vez:

Se o Content Type já existir pelo mesmo slug, ele é atualizado.
Se a Entry já existir pelo mesmo slug no mesmo Content Type, ela é atualizada.
Se não existir, ela é criada.
O status é aplicado depois de salvar a entry.

Importar Pelo Admin

Acesse o painel admin.
Abra Conteúdos.
Clique em Importar.
Importe primeiro o JSON de Content Types.
Depois importe o JSON de Entries.

Importar Pela API Admin

Envie contentTypes e/ou entries para /api/admin/import.

{
  "contentTypes": [
    {
      "name": "Posts",
      "slug": "posts",
      "fields": [
        { "name": "name", "type": "text", "required": true },
        { "name": "slug", "type": "text", "required": true }
      ]
    }
  ],
  "entries": [
    {
      "contentTypeSlug": "posts",
      "data": {
        "name": "Meu primeiro post",
        "slug": "meu-primeiro-post"
      },
      "status": "published"
    }
  ]
}

Esse endpoint exige sessão admin autenticada e token CSRF.

Dicas

Use slugs estáveis para permitir update no reimport.
Use markdown, não richtext.
Datas devem usar YYYY-MM-DD.
Para relações, garanta que a entry relacionada já exista antes da importação.