{"swagger":"2.0","info":{"title":"SmartSolosExpert","description":"A API SmartSolos Expert possibilita a classificação de perfis de solos do Brasil por meio de um sistema especialista implementado com base nas regras do Sistema Brasileiro de Classificação de Solos (SiBCS), que é o sistema taxonômico oficial para classificação de solos no Brasil. A partir dos dados relevantes para a classificação de solos, esta API é capaz de classificar os perfis nos quatro primeiros níveis do SiBCS.","version":"v1"},"host":"api.cnptia.embrapa.br","schemes":["https","http"],"basePath":"/smartsolos/expert/v1","produces":["application/json"],"consumes":["application/json"],"paths":{"/health":{"get":{"summary":"Verifica o status de funcionamento da API.","description":"Verifica o status de funcionamento da API.","tags":["Auxiliares"],"responses":{"204":{"description":"No Content."}},"x-auth-type":"Application & Application User","x-throttling-tier":"Unlimited"}},"/classification":{"post":{"summary":"Realiza a classificação de solo a partir de dados de perfis","description":"Realiza a classficação de solo segundo o SiBCS a partir de dados em JSON com perfis de solos","tags":["Classificação"],"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"body","name":"ProfileList","description":"List of soil profiles","schema":{"$ref":"#/definitions/ProfileList"}}],"responses":{"200":{"description":"Classificação realizada com sucesso","schema":{"$ref":"#/definitions/ClassificationList"},"examples":{"application/json":{"items":[{"ID_PONTO":"SD21ZD/P.22","ORDEM":"ORGANOSSOLO","SUBORDEM":"HÁPLICO","GDE_GRUPO":"Sáprico","SUBGRUPO":"típico"},{"ID_PONTO":"SD24YD/P.37","ORDEM":"ORGANOSSOLO","SUBORDEM":"FÓLICO","GDE_GRUPO":"Hêmico","SUBGRUPO":"típico"}]}}},"400":{"description":"Requisição inválida"},"401":{"description":"Requisição não autorizada"},"500":{"description":"Erro no servidor"}},"x-auth-type":"Application & Application User","x-throttling-tier":"Unlimited"}},"/verification":{"post":{"summary":"Realiza a classificação de solo a partir de dados de perfis e a compara com uma classificação fornecida","description":"Realiza a classficação de solo segundo o SiBCS a partir de dados em JSON com perfis de solos e verifica se equivale a uma classificação fornecida","tags":["Classificação"],"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"body","name":"ProfileList","description":"List of soil profiles","schema":{"$ref":"#/definitions/ProfileList"}}],"responses":{"200":{"description":"Verificação realizada com sucesso","schema":{"$ref":"#/definitions/Verification"},"examples":{"application/json":{"items":[{"ID_PONTO":"2003_SP1","ORDEM":"ORGANOSSOLO","SUBORDEM":"HÁPLICO","GDE_GRUPO":"Sáprico","SUBGRUPO":"térrico"}],"items_bd":[{"ID_PONTO":"2003_SP1","ORDEM":"ORGANOSSOLO","SUBORDEM":"MÉSICO","GDE_GRUPO":"Sáprico","SUBGRUPO":"térrico"}],"summary":{"L0":0,"L1":1,"L2":0,"L3":0,"L4":0}}}},"400":{"description":"Requisição inválida"},"401":{"description":"Requisição não autorizada"},"500":{"description":"Erro no servidor"}},"x-auth-type":"Application & Application User","x-throttling-tier":"Unlimited"}}},"definitions":{"ProfileList":{"type":"object","properties":{"items":{"description":"Lista de perfis","type":"array","items":{"$ref":"#/definitions/Profile"}}}},"Profile":{"type":"object","properties":{"ID_PONTO":{"description":"Identificador do ponto do perfil","type":"string"},"DRENAGEM":{"description":"Velocidade com que a água é removida do solo - de excessivamente drenado (1) a muito mal drenado (8)","type":"integer"},"HORIZONTES":{"description":"Lista de horizontes","type":"array","items":{"$ref":"#/definitions/Horizon"}},"ORDEM":{"description":"Classificação no 1o nível","type":"string"},"SUBORDEM":{"description":"Classificação no 2o nível","type":"string"},"GDE_GRUPO":{"description":"Classificação no 3o nível","type":"string"},"SUBGRUPO":{"description":"Classificação no 4o nível","type":"string"}}},"Horizon":{"type":"object","properties":{"SIMB_HORIZ":{"description":"Símbolo do horizonte","type":"string"},"LIMITE_SUP":{"description":"Limite superior do horizonte, em cm da superfície","type":"integer"},"LIMITE_INF":{"description":"Limite inferior do horizonte, em cm da superfície)","type":"integer"},"COR_UMIDA_MATIZ":{"description":"Matiz da cor da amostra de solo úmida","type":"string"},"COR_UMIDA_VALOR":{"description":"Valor da cor da amostra de solo úmida","type":"number"},"COR_UMIDA_CROMA":{"description":"Croma da cor da amostra de solo úmida","type":"number"},"COR_SECA_MATIZ":{"description":"Matiz da cor da amostra de solo seca","type":"string"},"COR_SECA_VALOR":{"description":"Valor da cor da amostra de solo seca","type":"number"},"COR_SECA_CROMA":{"description":"Croma da cor da amostra de solo seca","type":"number"},"COR_MOSQ_MATIZ_1":{"description":"Matiz da cor da mancha no solo (n-ésima ocorrência) - COR_MOSQ_MATIZ_N, N = 1,2,...","type":"string"},"COR_MOSQ_VALOR_1":{"description":"Valor da cor da mancha no solo (n-ésima ocorrência) - COR_MOSQ_VALOR_N, N = 1,2,...","type":"number"},"COR_MOSQ_CROMA_1":{"description":"Croma da cor da mancha no solo (n-ésima ocorrência) - COR_MOSQ_CROMA_N, N = 1,2,...","type":"number"},"COR_UMIDA_AMASSADA_MATIZ":{"description":"Matiz da cor da amostra de solo úmida e amassada","type":"string"},"COR_UMIDA_AMASSADA_VALOR":{"description":"Valor da cor da amostra de solo úmida e amassada","type":"number"},"COR_UMIDA_AMASSADA_CROMA":{"description":"Croma da cor da amostra de solo úmida e amassada","type":"number"},"COR_SECA_TRITURADA_MATIZ":{"description":"Matiz da cor da amostra de solo seca e triturada","type":"string"},"COR_SECA_TRITURADA_VALOR":{"description":"Valor da cor da amostra de solo seca e triturada","type":"number"},"COR_SECA_TRITURADA_CROMA":{"description":"Croma da cor da amostra de solo seca e triturada","type":"number"},"ESTRUTURA_GRAU":{"description":"Grau de desenvolvimento da estrutura - de ausente (1) a forte(4)","type":"integer"},"ESTRUTURA_TAMANHO":{"description":"Tamanho da estrutura - de muito pequeno (1) a extremamente grande (6)","type":"integer"},"ESTRUTURA_TIPO":{"description":"Tipo, ou forma, da estrutura - laminar (1), prismática (2), colunar (3), blocos angulares (4), blocos subangulares (5), granular (6), grumosa (7)","type":"integer"},"CEROSIDADE_GRAU":{"description":"Grau de desenvolvimento da cerosidade, conforme o constraste com as partes sem cerosidade e facilidade de identificação - de ausente (1) a forte (4)","type":"integer"},"CEROSIDADE_QUANTIDADE":{"description":"Quantidade de cerosidade - de pouco (1) a abundante (3)","type":"integer"},"TRANSICAO_GRAU":{"description":"Grau, ou nitidez, da transição entre este horizonte e o subjacente - de abrupta (1) a difusa (4)","type":"integer"},"TRANSICAO_FORMA":{"description":"Forma, ou topografia, da transição entre este horizonte e o subjacente - plana (1), ondulada (2), irregular (3), descontínua (4)","type":"integer"},"CONSISTENCIA_SECO":{"description":"Consistência do solo seco (dureza) - de solto (1) a extremamente duro (6)","type":"integer"},"CALHAU":{"description":"Quantidade de calhau, em g/Kg","type":"integer"},"CASCALHO":{"description":"Quantidade de cascalho, em g/Kg","type":"integer"},"AREIA_GROS":{"description":"Quantidade de areia grossa, em g/Kg","type":"integer"},"AREIA_FINA":{"description":"Quantidade de areia fina, em g/Kg","type":"integer"},"SILTE":{"description":"Quantidade de silte, em g/Kg","type":"integer"},"ARGILA":{"description":"Quantidade de argila, em g/Kg","type":"integer"},"PH_AGUA":{"description":"pH com amostra de solo imerso em água","type":"number"},"PH_KCL":{"description":"pH com amostra de solo imerso em solução de KCl","type":"number"},"C_ORG":{"description":"Teor de carbono orgânico em g/Kg","type":"number"},"CA_TROC":{"description":"Cálcio trocável em cmol/Kg","type":"number"},"MG_TROC":{"description":"Magnésio trocável em cmol/Kg","type":"number"},"K_TROC":{"description":"Potássio trocável em cmol/Kg","type":"number"},"NA_TROC":{"description":"Sódio trocável em cmol/Kg","type":"number"},"AL_TROC":{"description":"Alumínio trocável em cmol/Kg","type":"number"},"H_TROC":{"description":"Hidrogênio trocável em cmol/Kg","type":"number"},"P_ASSIM":{"description":"Fósforo assimilável em mg/Kg","type":"integer"},"RETRATIL":{"description":"Tem caráter retrátil","type":"boolean"},"COESO":{"description":"Tem caráter coeso","type":"boolean"},"FLUVICO":{"description":"Tem caráter flúvico","type":"boolean"},"SOMBRICO":{"description":"Tem caráter sômbrico","type":"boolean"},"REDOXICO":{"description":"Tem caráter redóxico","type":"boolean"},"MATERIAIS_PRIMARIOS":{"description":"Indica presença de materiais primários alteráveis","type":"boolean"},"ATIVIDADES_HUMANAS":{"description":"Indica presença de atividades humanas","type":"boolean"},"PLACICO_TOPO":{"description":"Indica ocorrência de horizonte plácico no topo do horizonte em questão","type":"boolean"},"MANGANES":{"description":"Indica presença de manganês","type":"boolean"},"COND_ELETR":{"description":"Condutividade elétrica em dS/m","type":"integer"},"EQUI_CACO3":{"description":"Equivalente de carbonato de cálcio em g/Kg","type":"integer"},"TEOR_FE":{"description":"Teor de ferro em g/Kg","type":"integer"},"LAMELA_SUP":{"description":"Limite superior da lamela, em cm da superfície","type":"integer"},"LAMELA_INF":{"description":"Limite inferior da lamela, em cm da superfície)","type":"integer"},"LAMELA_TEXTURA":{"description":"Textura da lamela - de areia (1) a indiscriminado (16)","type":"integer"}}},"ClassificationList":{"type":"object","properties":{"items":{"description":"Lista de classificações","type":"array","items":{"$ref":"#/definitions/Classification"}}}},"Classification":{"type":"object","properties":{"ID_PONTO":{"description":"Identificador do ponto do perfil","type":"string"},"ORDEM":{"description":"Classificação no 1o nível","type":"string"},"SUBORDEM":{"description":"Classificação no 2o nível","type":"string"},"GDE_GRUPO":{"description":"Classificação no 3o nível","type":"string"},"SUBGRUPO":{"description":"Classificação no 4o nível","type":"string"}}},"Verification":{"type":"object","properties":{"items":{"description":"Lista de classificações obtidas pelo sistema especialista","type":"array","items":{"$ref":"#/definitions/Classification"}},"items_bd":{"description":"Lista de classificações prévias fornecidas ao sistema para verificação","type":"array","items":{"$ref":"#/definitions/Classification"}},"summary":{"description":"Quantidade de perfis que coincidem na classificação nos níveis 1 (L1) , 2 (L2), 3 (L3), 4 (L4) ou não coincidem (L0)","type":"object","properties":{"L0":{"description":"Quantidade de perfis cuja classificação não coincide com a fornecida","type":"integer"},"L1":{"description":"Quantidade de perfis cuja classificação coincide apenas no primeiro nível com a fornecida","type":"integer"},"L2":{"description":"Quantidade de perfis cuja classificação coincide nos níveis 1 e 2 com a fornecida","type":"integer"},"L3":{"description":"Quantidade de perfis cuja classificação coincide nos níveis 1, 2 e 3 com a fornecida","type":"integer"},"L4":{"description":"Quantidade de perfis cuja classificação coincide nos quatro níveis com a fornecida","type":"integer"}}}}}},"securityDefinitions":{"default":{"type":"oauth2","authorizationUrl":"https://api.cnptia.embrapa.br/authorize","flow":"implicit","scopes":{}}}}