Bloco de códigohtml |
---|
{ "openapi": "3.0.1", "servers": [ { "description": "API para os parâmetros de sistemas do produtos TOTVS", "url": "{{host}}/api/framework/v1", "variables": { "serverUrl": { "default": "localhost" }, "serverHttpPort": { "default": "8051" } } } ], "info": { "description": "API para os parâmetros de sistemas do produtos TOTVS", "version": "1.000", "title": "Parametros de Sistema", "contact": { "name": "T-Talk", "url": "API.Totvs.com.br", "email": "[email protected]" }, "x-totvs": { "messageDocumentation": { "name": "systemParameters", "description": "Parâmetros de Sistema", "segment": "Foundation" }, "productInformation": [ { "product": "Protheus", "contact": "[email protected]", "description": "Cadastro de parâmetros", "adapter": "", "helpUrl": "link aqui", "note": "Essa API exige que seja configurada a segurança no servidor (SECURITY=1)." } ] } }, "paths": { "/systemParameters": { "get": { "tags": [ "System Parameters" ], "summary": "Retorna todos os parâmetros do sistema", "x-totvs": { "productInformation": [ { "product": "Protheus", "available": true, "note": "Este verbo esta disponivel com todos os parametros", "minimalVersion": "12.1.23" } ] }, "description": "Retorna todos os parâmetros do sistema", "operationId": "getSystemParameters", "parameters": [ { "$ref": "https://raw.githubusercontent.com/totvs/ttalk-standard-message/master/jsonschema/apis/types/totvsApiTypesBase.json#/parameters/Authorization" }, { "$ref": "https://raw.githubusercontent.com/totvs/ttalk-standard-message/master/jsonschema/apis/types/totvsApiTypesBase.json#/parameters/Order" }, { "$ref": "https://raw.githubusercontent.com/totvs/ttalk-standard-message/master/jsonschema/apis/types/totvsApiTypesBase.json#/parameters/Page" }, { "$ref": "https://raw.githubusercontent.com/totvs/ttalk-standard-message/master/jsonschema/apis/types/totvsApiTypesBase.json#/parameters/PageSize" }, { "$ref": "https://raw.githubusercontent.com/totvs/ttalk-standard-message/master/jsonschema/apis/types/totvsApiTypesBase.json#/parameters/Fields" }, { "$ref": "#/components/parameters/Codes" }, { "$ref": "https://raw.githubusercontent.com/totvs/ttalk-standard-message/master/jsonschema/apis/types/totvsApiTypesBase.json#/parameters/AcceptLanguage" }, { "$ref": "#/components/parameters/Description" } ], "responses": { "200": { "description": "Operação realizada com sucesso", "content": { "application/json": { "schema": { "$ref": "https://raw.githubusercontent.com/totvs/ttalk-standard-message/master/jsonschema/schemas/SystemParameter_1_000.json#/definitions/PagedParameters" } } } } } }, "post": { "tags": [ "System Parameters" ], "summary": "Inclui o parâmetro passado na requisição", "description": "Inclui o parâmetro passado na requisição", "operationId": "postParameter", "x-totvs": { "productInformation": [ { "product": "Protheus", "available": true, "note": "Este verbo esta disponivel com todos os parametros", "minimalVersion": "12.1.23" } ] }, "parameters": [ { "$ref": "https://raw.githubusercontent.com/totvs/ttalk-standard-message/master/jsonschema/apis/types/totvsApiTypesBase.json#/parameters/Authorization" } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "https://raw.githubusercontent.com/totvs/ttalk-standard-message/master/jsonschema/schemas/SystemParameter_1_000.json#/definitions/ParameterInfo" } } }, "description": "Parâmetro para ser incluido" }, "responses": { "200": { "description": "Operação realizada com sucesso", "content": { "application/json": { "schema": { "$ref": "https://raw.githubusercontent.com/totvs/ttalk-standard-message/master/jsonschema/schemas/SystemParameter_1_000.json#/definitions/PagedParameters" } } } }, "400": { "description": "erro no momento da Inclusão", "content": { "application/json": { "schema": { "$ref": "https://raw.githubusercontent.com/totvs/ttalk-standard-message/master/jsonschema/apis/types/totvsApiTypesBase.json#/definitions/ErrorModel" } } } } } } }, "/systemParameters/{systemParameterId}": { "put": { "tags": [ "System Parameters" ], "summary": "Altera o parâmetro passado na requisição", "description": "Altera o parâmetro passado na requisição", "operationId": "postParameterId", "x-totvs": { "productInformation": [ { "product": "Protheus", "available": true, "note": "Este verbo esta disponivel com todos os parametros", "minimalVersion": "12.1.23" } ] }, "parameters": [ { "$ref": "#/components/parameters/ParameterId" }, { "$ref": "https://raw.githubusercontent.com/totvs/ttalk-standard-message/master/jsonschema/apis/types/totvsApiTypesBase.json#/parameters/Authorization" } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "https://raw.githubusercontent.com/totvs/ttalk-standard-message/master/jsonschema/schemas/SystemParameter_1_000.json#/definitions/ParameterInfo" } } }, "description": "Parâmetro para ser incluído" }, "responses": { "200": { "description": "Operação realizada com sucesso", "content": { "application/json": { "schema": { "$ref": "https://raw.githubusercontent.com/totvs/ttalk-standard-message/master/jsonschema/schemas/SystemParameter_1_000.json#/definitions/ParameterInfo" } } } }, "400": { "description": "erro no momento da Inclusão", "content": { "application/json": { "schema": { "$ref": "https://raw.githubusercontent.com/totvs/ttalk-standard-message/master/jsonschema/apis/types/totvsApiTypesBase.json#/definitions/ErrorModel" } } } }, "404": { "description": "Parâmetro não localizado na base", "content": { "application/json": { "schema": { "$ref": "https://raw.githubusercontent.com/totvs/ttalk-standard-message/master/jsonschema/apis/types/totvsApiTypesBase.json#/definitions/ErrorModel" } } } } } }, "delete": { "tags": [ "System Parameters" ], "summary": "Exclusão de parâmetro da base", "description": "Exclusão de parâmetro da base", "operationId": "DeleteParameterId", "x-totvs": { "productInformation": [ { "product": "Protheus", "available": true } ] }, "parameters": [ { "$ref": "#/components/parameters/ParameterId" } ], "responses": { "200": { "description": "Operação realizada com sucesso", "content": { "application/json": { "schema": { "$ref": "https://raw.githubusercontent.com/totvs/ttalk-standard-message/master/jsonschema/schemas/SystemParameter_1_000.json#/definitions/ParameterInfo" } } } }, "405": { "description": "Não disponivel", "content": { "application/json": { "schema": { "$ref": "https://raw.githubusercontent.com/totvs/ttalk-standard-message/master/jsonschema/apis/types/totvsApiTypesBase.json#/definitions/ErrorModel" } } } } } } } }, "components": { "parameters": { "ParameterId": { "name": "systemParameterId", "in": "path", "required": true, "description": "Identificador Único representando o parâmetro", "schema": { "type": "string" } }, "Codes": { "name": "codes", "in": "query", "description": "Códigos de parâmetros retornados pelo get separado por vírgula (,) ", "required": false, "example": "param1,param2", "schema": { "type": "string" } }, "Description": { "name": "description", "in": "query", "description": "Busca de descrição do paramêtro", "required": false, "example": "Parâmetro de busca", "schema": { "type": "string" } } } } } |