Inserindo uma entidade de document

POST https://api.fbits.net/document/entities


Parâmetros para criação:

  • name - nome da entidade, único na loja e com até 100 caracteres;
  • schema - JSON Schema (draft 2020-12) dos documents da entidade, com raiz type: object;
  • publicOperations - operações públicas da entidade: CREATE, READ, UPDATE, DELETE (opcional).

Request body:

{
  "name": "ficha-tecnica",
  "schema": "{\"type\":\"object\",\"properties\":{\"sku\":{\"type\":\"string\",\"publicView\":true},\"peso\":{\"type\":\"number\"}},\"required\":[\"sku\"]}",
  "publicOperations": ["READ"]
}

Response body:

{
  "id": 12,
  "name": "ficha-tecnica",
  "schema": "{\"$schema\":\"https://json-schema.org/draft/2020-12/schema\",\"type\":\"object\",\"properties\":{\"sku\":{\"type\":\"string\",\"publicView\":true},\"peso\":{\"type\":\"number\",\"publicView\":false}},\"required\":[\"sku\"]}",
  "publicOperations": ["READ"],
  "createdAt": "2026-07-27T13:45:10.123Z",
  "updatedAt": "2026-07-27T13:45:10.123Z"
}
🚧

O retorno é 409 quando já existe uma entidade com o mesmo nome na loja e 400 quando o schema informado não é um JSON Schema válido ou não declara type: object na raiz.