Atualizar os dados de uma Fazenda

Descrição: Atualiza os dados de uma fazenda a partir do id.

Endpoint

PUT/api/v1/integration/farms/{farm_id}

Regras

Atributos	Descrição	Tipo	Obrigatório	Validações
farm_id	Identificador da fazenda	UUID	Sim	-
state_subscription	Inscrição estadual	String	Não	Formato: inscrição-Estado. Ex: 123456-MS
name	Nome	String	Sim	Permite até 250 caracteres
own	Tipo de propriedade	Boolean	Sim	true para própria, false para alugada
registration	Número de matricula	String	Não	Até 100 caracteres

Exemplo de Requisição

cURL

curl -X PUT \
  -H "Authorization: {SUA_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Fazenda Boa Vista Atualizada",
    "own": true,
    "state_subscription": "654321-MT",
    "registration": "REG-002"
  }' \
  "https://api.merx.tech/api/v1/integration/farms/{FARM_ID}"

Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

String body = "{\"name\": \"Fazenda Boa Vista Atualizada\", \"own\": true, \"state_subscription\": \"654321-MT\", \"registration\": \"REG-002\"}";

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.merx.tech/api/v1/integration/farms/{FARM_ID}"))
    .header("Authorization", "{SUA_API_KEY}")
    .header("Content-Type", "application/json")
    .PUT(HttpRequest.BodyPublishers.ofString(body))
    .build();

HttpClient client = HttpClient.newHttpClient();
try {
    HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    System.out.println(response.statusCode());
} catch (Exception e) {
    e.printStackTrace();
}

JavaScript

const response = await fetch(
  'https://api.merx.tech/api/v1/integration/farms/{FARM_ID}',
  {
    method: 'PUT',
    headers: {
      'Authorization': '{SUA_API_KEY}',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      name: 'Fazenda Boa Vista Atualizada',
      own: true,
      state_subscription: '654321-MT',
      registration: 'REG-002',
    }),
  }
);
console.log(response.status);

Python

import requests

url = "https://api.merx.tech/api/v1/integration/farms/{FARM_ID}"

headers = {
    "Authorization": "{SUA_API_KEY}",
    "Content-Type": "application/json"
}

payload = {
    "name": "Fazenda Boa Vista Atualizada",
    "own": True,
    "state_subscription": "654321-MT",
    "registration": "REG-002"
}

response = requests.put(url, json=payload, headers=headers)
print(response.status_code)

Parâmetros

Parâmetros de Caminho:

Nome	Descrição	Tipo	Obrigatório
farm_id	Identificador da fazenda	String	Sim

Parâmetros de Cabeçalho

Nome	Descrição	Tipo	Obrigatório
Authorization	Chave de API obtida via support-api@merx.tech	String	Sim
Content-Type	application/json	String	Sim

Respostas

• 204 - No Content

• 400 - Bad Request

{
  "messages": ["message.entidade.campo-inválido"]
}

• 401 - Unauthorized

• 404 - NotFound