Documentação API Altura

Introdução

A API permite coletar, armazenar e consultar dados de altura de girassóis através de endpoints RESTful.

Características

Suporte a requisições GET e POST
Respostas em JSON com codificação UTF-8
CORS habilitado para acesso cross-domain
Tratamento de erros padronizado

Status da API

Endpoints

Status da API

GET

Verifica se a API está online e funcionando.

URL: /status

Exemplo de Resposta:

{
  "status": "online",
  "mensagem": "API REST - Do Solo à Nuvem",
  "timestamp": "2023-10-15 14:30:00",
  "versao": "1.0"
}

Listar Todos os Dados

GET

Retorna todos os registros de altura armazenados em 'dados'.

URL: /getListarDados

Exemplo de Resposta:

{
  {
  "status": "sucesso",
  "dados": [
    {
      "data": "2025-10-13 23:52:38",
      "dados": "23;4;10;66;66;43;3;33;78;14;89;0;6;",
      "operacao": 0
    },
    {
      "data": "2025-10-14 23:52:38",
      "dados": "23;4;5;66;66;43;3;22;78;12;7;0;0;12;34;1;78;9;56;",
      "operacao": 0
    },
    {
      "data": "2025-10-14 23:53:38",
      "dados": "23;4;5;66;66;43;3;22;78;12;23;4;5;66;66;43;3;22;78;12",
      "operacao": 0
    }
  ]
}
}

Listar Dados por Data

GET

Retorna registros de altura de uma data específica.

URL: /getListarDadosData/{data}

Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição
`data`	String	Sim	Data no formato YYYY-MM-DD

Exemplo de Resposta:

{
  {
  "status": "sucesso",
  "dados": [
    {
      "data": "2025-10-13 23:52:38",
      "dados": "23;4;10;66;66;43;3;33;78;14;89;0;6;",
      "operacao": 0
    }
  ]
}
}

Pesquisar por Intervalo de Datas

GET

Retorna registros de altura dentro de um intervalo de datas.

URL: /getPesquisarData/{data_inicio}D{data_fim}

Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição
`data_inicio`	String	Sim	Data inicial no formato YYYY-MM-DD
`data_fim`	String	Sim	Data final no formato YYYY-MM-DD

Exemplo de Resposta:

{
  {
  "status": "sucesso",
  "dados": [
    {
      "data": "2025-10-13 23:52:38",
      "dados": "23;4;10;66;66;43;3;33;78;14;89;0;6;",
      "operacao": 0
    },
    {
      "data": "2025-10-14 23:52:38",
      "dados": "23;4;5;66;66;43;3;22;78;12;7;0;0;12;34;1;78;9;56;",
      "operacao": 0
    }
  ]
}
}

Salvar Dados Altura

POST/GET

Insere novos registros de altura (dados) no banco de dados.

URL: /salvarDados

Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição
`data`	timestamp	Não	Valor automático pelo servidor
`dados`	Text	Sim	Valor de várias alturas separados por ;
`operacao`	Integer	Sim	Código de operação (ex: 0 - Fase de testes, 1 para dados reais, 2 para eliminação de dados pelo admin)

Exemplo de Requisição (POST):

// Form Data
dados=23;4;10;66;66;43;3;33;78;14;89;0;6;&operacao=1

Exemplo de Requisição (GET):

GET /salvarDados?dados=23;4;10;66;66;43;3;33;78;14;89;0;6;&operacao=1

Exemplo de Resposta (Sucesso):

{
  "status": "sucesso",
  "mensagem": "Dados salvos com sucesso",
  "dados_salvos": {
    "dados": 23;4;10;66;66;43;3;33;78;14;89;0;6;,
    "operacao": 1
  }
}

Exemplo de Resposta (Erro):

{
  "status": "erro",
  "mensagem": "Parâmetros incompletos. São necessários: altura (dados) e operacao."
}

Exemplos de Uso

JavaScript (Fetch API)

// Listar todos os dados
fetch('https://apigirassol.roboticasuassuna.com.br/apiAltura/getListarDados')
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Erro:', error));

// Salvar dados via POST
const formData = new URLSearchParams();
formData.append('dados', '23;4;10;66;66;43;3;33;78;14;89;0;6;');
formData.append('operacao', '1');

fetch('https://apigirassol.roboticasuassuna.com.br/apiAltura/salvarDados', {
  method: 'POST',
  body: formData
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Erro:', error));

Python (requests)

import requests
import json

# Listar todos os dados
url = "https://apigirassol.roboticasuassuna.com.br/apiAltura/getListarDados"
response = requests.get(url)
data = response.json()
print(json.dumps(data, indent=2))

# Salvar dados via POST
url = "https://apigirassol.roboticasuassuna.com.br/apiAltura/salvarDados"
dados = {
    'dados': '23;4;10;66;66;43;3;33;78;14;89;0;6;',
    'operacao': 1
}

response = requests.post(url, data=dados)
resultado = response.json()
print(json.dumps(resultado, indent=2))

# Salvar dados via GET (alternativa)
params = {
    'dados': '23;4;10;66;66;43;3;33;78;14;89;0;6;',
    'operacao': 1
}
response = requests.get(url, params=params)
resultado = response.json()
print(json.dumps(resultado, indent=2))

# Pesquisar por intervalo de datas
url = "https://apigirassol.roboticasuassuna.com.br/apiAltura/getPesquisarData/2023-10-01D2023-10-15"
response = requests.get(url)
data = response.json()
print(json.dumps(data, indent=2))

Códigos de Status HTTP

Código	Significado	Descrição
200	OK	Requisição bem-sucedida
201	Created	Recurso criado com sucesso
400	Bad Request	Parâmetros inválidos ou faltantes
500	Internal Server Error	Erro interno do servidor