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
    • 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

Em desenvolvimento
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:Não configurado

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
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api-develop.enspace.io/ws/types//items' \
--header 'Content-Type: application/json' \
--header 'x-api-key;' \
--header 'en-workspace;' \
--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

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 Path
slug
string 
requerido
Slug do Type
Parâmetros Bodyapplication/json
id
integer 
requerido
ID único do item
reference
string 
requerido
Slug do type ao qual o item pertence
status
string 
requerido
Status
created_at
string <date-time>
requerido
updated_at
string <date-time>
requerido
type
object (Type) 
requerido
id
integer 
requerido
ID único do type
name
string 
requerido
Nome do type
slug
string 
requerido
Slug único do type
description
string 
opcional
Descrição do type
created_at
string <date-time>
requerido
updated_at
string <date-time>
requerido
fields_count
integer 
opcional
Número de campos do type
items_count
integer 
opcional
Número de items do type
config
object 
opcional
Configurações específicas do type
data
object 
requerido
Examples

Respostas

🟢200OK
application/json
Item criado com sucesso.
Body
No schema defined
🟠400Pedido inválido
🟠401Não autorizado
🟠404Registro não encontrado
Página anterior
Listar items
Próxima página
Contar items
Built with