Enspace
  1. Items
Enspace
  • Introdução
  • Autenticação
  • Conceitos
  • Primeiros Passos
  • Workspaces
    • Categorias
      • Campos
        • Listar campos
        • Criar campo
        • Obter campo específico
        • Atualizar campo
        • Excluir campo
      • Items
        • Listar items
          GET
        • Criar novo item
          POST
        • Contar items
          GET
        • Obter item específico
          GET
        • Atualizar item
          PUT
        • Remover item
          DELETE
      • Listar categorias
        GET
      • Contar categorias
        GET
      • Obter categoria específica
        GET
      • Criar categoria
        POST
      • Atualizar categoria
        PUT
      • Excluir categoria
        DELETE
    • Membros
      • Listar membros
      • Contar membros
      • Obter membro
      • Novo membro
      • Atualizar membro
      • Remover membro
    • Cargos
      • Listar cargos
      • Criar cargo
      • Obter cargo específica
      • Contar cargos
      • Atualizar cargo
      • Excluir cargo
      • Listar Permissões da Role
      • Adicionar Permissão à Role
      • Remover Permissão da Role
    • Grupos de Membros
      • Listar grupos
      • Novo grupo
      • Obter grupo
      • Atualizar grupo
      • Excluir grupo
      • Adicionar Usuários
      • Remover Usuários
    • Listar Workspaces
      GET
    • Contexto do Workspace
      GET
    • Novo Workspace
      POST
    • Sair do workspace
      POST
    • Estatísticas do Workspace
      GET
    • Prévia de Exclusão do Workspace
      GET
    • Excluir Workspace
      DELETE
  • Usuário
    • Logs de Auditoria
    • Listar Chaves de API
  1. Items

Criar novo item

Develop Env
https://api-develop.enspace.io
Develop Env
https://api-develop.enspace.io
POST
https://api-develop.enspace.io
/ws/types/{slug}/items
Responsável:Julio Cordeiro

Criar Item#

Cria uma nova instância de dados (item) para um Type específico.

Parâmetros#

slug (path) - Slug único do Type

Corpo da Requisição#

CampoTipoObrigatórioDescrição
referencestringSimIdentificador único do item (ex: "PROD-001")
dataobjectSimObjeto com os dados baseados nos fields do Type
statusstringNãoEstado do item (padrão: "active")

Exemplo de Requisição#

{
  "reference": "PROD-001",
  "data": {
    "nome": "iPhone 15",
    "preco": 4999.99,
    "categoria": "eletrônicos",
    "disponivel": true
  }
}

Validações#

A referência deve ser única dentro do Type
Os campos obrigatórios definidos no Type devem ser preenchidos
Os tipos de dados devem corresponder aos tipos dos fields
Campos do tipo select devem ter valores válidos conforme as opções

Exemplo de Resposta#

{
  "id": 1,
  "reference": "PROD-001",
  "status": "active",
  "data": {
    "nome": "iPhone 15",
    "preco": 4999.99,
    "categoria": "eletrônicos",
    "disponivel": true
  },
  "type": {
    "id": 1,
    "slug": "produto",
    "name": "Produto"
  },
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-15T10:30:00Z"
}

Erros Comuns#

409 Conflict: Referência já existe
400 Bad Request: Campos obrigatórios faltando ou tipos inválidos
404 Not Found: Type não encontrado

Requisição

Authorization
API Key
Adicionar parâmetro em header
x-api-key
Exemplo:
x-api-key: ********************
API Key
Adicionar parâmetro em header
en-workspace
Exemplo:
en-workspace: ********************
or
Parâmetros de Caminho

Parâmetros Bodyapplication/json

Examples

Respostas

🟢200OK
application/json
Item criado com sucesso.
Body

🟠400Pedido inválido
🟠401Não autorizado
🟠404Registro não encontrado
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api-develop.enspace.io/ws/types//items' \
--header 'x-api-key: <api-key>' \
--header 'en-workspace: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "id": 0,
    "reference": "string",
    "status": "string",
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z",
    "type": {
        "id": 0,
        "name": "string",
        "slug": "string",
        "description": "string",
        "created_at": "2019-08-24T14:15:22Z",
        "updated_at": "2019-08-24T14:15:22Z",
        "fields_count": 0,
        "items_count": 0,
        "config": {}
    },
    "data": {}
}'
Response Response Example
200 - Exemplo 1
Página anterior
Listar items
Próxima página
Contar items
Built with