ValidacaoController

Fase 10: Validação dos dados da safra

Endpoint: /validacao

method: POST

path: /validacao

description: Endpoint para cadastrar

parameters:
  - name: entity
    type: CreateChainEntity
    description: Parâmetro entity
    required: true
    in: body

Exemplo de requisição:

curl --request POST \
  --url https://<url>/validacao \
  --header 'X-API-ACCESS-KEY: <chave_de_acesso>' \
  --header 'X-API-SECRET-KEY: <chave_de_seguranca>' \
  -d '{
    "safraId": "<id_safra>",
    "safraCodigo": "<codigo_safra>",
    "dados": {
      ...
    }
  }'

Exemplo de resposta:

{
    "status": "success",
    "message": "Operação realizada com sucesso",
    "data": {}
}

Exemplo de erro:

{
    "status": "error",
    "message": "Erro na operação",
    "code": 500
}

Endpoint: /validacao

method: PUT

path: /validacao

description: Endpoint para atualizar

parameters:
  - name: entity
    type: UpdateChainEntity
    description: Parâmetro entity
    required: true
    in: body

Exemplo de requisição:

curl --request PUT \
  --url https://<url>/validacao \
  --header 'X-API-ACCESS-KEY: <chave_de_acesso>' \
  --header 'X-API-SECRET-KEY: <chave_de_seguranca>' \
  -d '{
    "safraId": "<id_safra>",
    "safraCodigo": "<codigo_safra>",
    "dados": {
      ...
    }
  }'

Exemplo de resposta:

{
    "status": "success",
    "message": "Operação realizada com sucesso",
    "data": {}
}

Exemplo de erro:

{
    "status": "error",
    "message": "Erro na operação",
    "code": 500
}

Endpoint: /validacao/{id}

method: GET

path: /validacao/{id}

description: Endpoint para getById

parameters:
  - name: id
    type: String
    description: Parâmetro id
    required: true
    in: path

Exemplo de requisição:

curl --request GET \
  --url https://<url>/validacao/{id} \
  --header 'X-API-ACCESS-KEY: <chave_de_acesso>' \
  --header 'X-API-SECRET-KEY: <chave_de_seguranca>'

Exemplo de resposta:

{
    "status": "success",
    "message": "Operação realizada com sucesso",
    "data": {}
}

Exemplo de erro:

{
    "status": "error",
    "message": "Erro na operação",
    "code": 500
}

Endpoint: /validacao/safra/{id}

method: GET

path: /validacao/safra/{id}

description: Endpoint para getBySafra

parameters:
  - name: id
    type: String
    description: Parâmetro id
    required: true
    in: path

Exemplo de requisição:

curl --request GET \
  --url https://<url>/validacao/safra/{id} \
  --header 'X-API-ACCESS-KEY: <chave_de_acesso>' \
  --header 'X-API-SECRET-KEY: <chave_de_seguranca>'

Exemplo de resposta:

{
    "status": "success",
    "message": "Operação realizada com sucesso",
    "data": {}
}

Exemplo de erro:

{
    "status": "error",
    "message": "Erro na operação",
    "code": 500
}

Endpoint: /validacao

method: GET

path: /validacao

description: Endpoint para listar

parameters:
  - name: =
    type: (size
    description: Parâmetro =
    required: false
    in: query
  - name: =
    type: sort
    description: Parâmetro =
    required: false
    in: query

Exemplo de requisição:

curl --request GET \
  --url https://<url>/validacao \
  --header 'X-API-ACCESS-KEY: <chave_de_acesso>' \
  --header 'X-API-SECRET-KEY: <chave_de_seguranca>'

Exemplo de resposta:

{
    "status": "success",
    "message": "Operação realizada com sucesso",
    "data": {}
}

Exemplo de erro:

{
    "status": "error",
    "message": "Erro na operação",
    "code": 500
}

Endpoint: /validacao/{id}

method: DELETE

path: /validacao/{id}

description: Endpoint para excluir

parameters:
  - name: id
    type: String
    description: Parâmetro id
    required: true
    in: path

Exemplo de requisição:

curl --request DELETE \
  --url https://<url>/validacao/{id} \
  --header 'X-API-ACCESS-KEY: <chave_de_acesso>' \
  --header 'X-API-SECRET-KEY: <chave_de_seguranca>'

Exemplo de resposta:

{
    "status": "success",
    "message": "Operação realizada com sucesso",
    "data": {}
}

Exemplo de erro:

{
    "status": "error",
    "message": "Erro na operação",
    "code": 500
}

Endpoint: /validacao/qrcode/{codigo}

method: GET

path: /validacao/qrcode/{codigo}

description: Endpoint para generateQRCode

parameters:
  - name: codigo
    type: String
    description: Parâmetro codigo
    required: true
    in: path

Exemplo de requisição:

curl --request GET \
  --url https://<url>/validacao/qrcode/{codigo} \
  --header 'X-API-ACCESS-KEY: <chave_de_acesso>' \
  --header 'X-API-SECRET-KEY: <chave_de_seguranca>'

Exemplo de resposta:

{
    "status": "success",
    "message": "Operação realizada com sucesso",
    "data": {}
}

Exemplo de erro:

{
    "status": "error",
    "message": "Erro na operação",
    "code": 500
}