QdC Partner Support API

https://qdc-partner-support.imagelinenetwork.com/docs
Admin
QdC Partner Support API is an integration platform providing partner access to Quaderno di Campagna...
Tokens:4,468
Snippets:6
Trust Score:9.3
Update:7 months ago
Show doc for...
Tokens:
Raw
### Authentication API

Source: https://qdc-partner-support.imagelinenetwork.com/docs/index

Handles authentication and token generation for accessing the QdC Partner Support API.

```APIDOC
## POST /oauth2/auth

### Description
Handles form-based authentication to initiate the authorization process.

### Method
POST

### Endpoint
/oauth2/auth

### Parameters
#### Request Body
- **username** (string) - Required - The username for authentication.
- **password** (string) - Required - The password for authentication.

### Request Example
```json
{
  "username": "your_username",
  "password": "your_password"
}
```

### Response
#### Success Response (200)
- **access_token** (string) - The generated access token.
- **token_type** (string) - The type of token (e.g., Bearer).
- **expires_in** (integer) - The token's expiration time in seconds.

#### Response Example
```json
{
  "access_token": "generated_access_token",
  "token_type": "Bearer",
  "expires_in": 3600
}
```
```

```APIDOC
## POST /oauth2/token

### Description
Generates an access token using an authorization code or refresh token.

### Method
POST

### Endpoint
/oauth2/token

### Parameters
#### Request Body
- **grant_type** (string) - Required - The grant type (e.g., 'authorization_code', 'refresh_token').
- **code** (string) - Required if grant_type is 'authorization_code' - The authorization code received.
- **refresh_token** (string) - Required if grant_type is 'refresh_token' - The refresh token.
- **redirect_uri** (string) - Optional - The redirect URI used during authorization.

### Request Example
```json
{
  "grant_type": "authorization_code",
  "code": "received_auth_code",
  "redirect_uri": "https://your.redirect.uri"
}
```

### Response
#### Success Response (200)
- **access_token** (string) - The generated access token.
- **token_type** (string) - The type of token (e.g., Bearer).
- **expires_in** (integer) - The token's expiration time in seconds.

#### Response Example
```json
{
  "access_token": "new_access_token",
  "token_type": "Bearer",
  "expires_in": 3600
}
```
```

```APIDOC
## POST /oauth2/refresh

### Description
Refreshes an expired access token using a valid refresh token.

### Method
POST

### Endpoint
/oauth2/refresh

### Parameters
#### Request Body
- **refresh_token** (string) - Required - The refresh token to use for obtaining a new access token.

### Request Example
```json
{
  "refresh_token": "your_refresh_token"
}
```

### Response
#### Success Response (200)
- **access_token** (string) - The new access token.
- **token_type** (string) - The type of token (e.g., Bearer).
- **expires_in** (integer) - The new token's expiration time in seconds.

#### Response Example
```json
{
  "access_token": "refreshed_access_token",
  "token_type": "Bearer",
  "expires_in": 3600
}
```
```

--------------------------------

### QdC Data API

Source: https://qdc-partner-support.imagelinenetwork.com/docs/index

Provides access to various data points from the QdC system.

```APIDOC
## GET /qdc/aziende

### Description
Retrieves a list of companies within the QdC system.

### Method
GET

### Endpoint
/qdc/aziende

### Parameters
None

### Response
#### Success Response (200)
- **companies** (array) - A list of company objects.
  - **id** (string) - The unique identifier for the company.
  - **name** (string) - The name of the company.

#### Response Example
```json
{
  "companies": [
    {"id": "comp1", "name": "AgriCorp"},
    {"id": "comp2", "name": "Farm Solutions"}
  ]
}
```
```

```APIDOC
## GET /qdc/unitaproduttive

### Description
Retrieves a list of production units within the QdC system.

### Method
GET

### Endpoint
/qdc/unitaproduttive

### Parameters
#### Query Parameters
- **company_id** (string) - Optional - Filter by company ID.

### Response
#### Success Response (200)
- **production_units** (array) - A list of production unit objects.
  - **id** (string) - The unique identifier for the production unit.
  - **name** (string) - The name of the production unit.
  - **company_id** (string) - The ID of the company this unit belongs to.

#### Response Example
```json
{
  "production_units": [
    {"id": "pu1", "name": "North Farm", "company_id": "comp1"},
    {"id": "pu2", "name": "South Farm", "company_id": "comp1"}
  ]
}
```
```

```APIDOC
## GET /qdc/unitaproduttiva_fascicolo

### Description
Retrieves the file or dossier for a specific production unit.

### Method
GET

### Endpoint
/qdc/unitaproduttiva_fascicolo

### Parameters
#### Query Parameters
- **production_unit_id** (string) - Required - The ID of the production unit.

### Response
#### Success Response (200)
- **dossier** (object) - An object containing the production unit's dossier information.
  - **unit_id** (string) - The ID of the production unit.
  - **details** (string) - Detailed information about the production unit.

#### Response Example
```json
{
  "dossier": {
    "unit_id": "pu1",
    "details": "Details about North Farm, including crop types, soil analysis, etc."
  }
}
```
```

```APIDOC
## GET /qdc/interventi

### Description
Retrieves a list of interventions recorded in the QdC system.

### Method
GET

### Endpoint
/qdc/interventi

### Parameters
#### Query Parameters
- **production_unit_id** (string) - Optional - Filter interventions by production unit ID.
- **start_date** (string) - Optional - Filter interventions starting from this date (YYYY-MM-DD).
- **end_date** (string) - Optional - Filter interventions up to this date (YYYY-MM-DD).

### Response
#### Success Response (200)
- **interventions** (array) - A list of intervention objects.
  - **id** (string) - The unique identifier for the intervention.
  - **date** (string) - The date of the intervention.
  - **type** (string) - The type of intervention.
  - **description** (string) - A description of the intervention.

#### Response Example
```json
{
  "interventions": [
    {"id": "int1", "date": "2023-10-26", "type": "Fertilization", "description": "Applied NPK fertilizer"},
    {"id": "int2", "date": "2023-10-27", "type": "Pest Control", "description": "Sprayed insecticide"}
  ]
}
```
```

```APIDOC
## GET /qdc/macchine

### Description
Retrieves a list of machinery registered in the QdC system.

### Method
GET

### Endpoint
/qdc/macchine

### Parameters
#### Query Parameters
- **company_id** (string) - Optional - Filter by company ID.

### Response
#### Success Response (200)
- **machinery** (array) - A list of machinery objects.
  - **id** (string) - The unique identifier for the machinery.
  - **name** (string) - The name of the machinery.
  - **model** (string) - The model of the machinery.

#### Response Example
```json
{
  "machinery": [
    {"id": "mach1", "name": "Tractor", "model": "John Deere 6195M"},
    {"id": "mach2", "name": "Harvester", "model": "New Holland CX8.80"}
  ]
}
```
```

```APIDOC
## GET /qdc/operatori

### Description
Retrieves a list of operators registered in the QdC system.

### Method
GET

### Endpoint
/qdc/operatori

### Parameters
#### Query Parameters
- **company_id** (string) - Optional - Filter by company ID.

### Response
#### Success Response (200)
- **operators** (array) - A list of operator objects.
  - **id** (string) - The unique identifier for the operator.
  - **name** (string) - The name of the operator.

#### Response Example
```json
{
  "operators": [
    {"id": "optr1", "name": "Mario Rossi"},
    {"id": "optr2", "name": "Luigi Bianchi"}
  ]
}
```
```

```APIDOC
## GET /qdc/magazzini/giacenze

### Description
Retrieves inventory (giacenze) information from warehouses in the QdC system.

### Method
GET

### Endpoint
/qdc/magazzini/giacenze

### Parameters
#### Query Parameters
- **warehouse_id** (string) - Optional - Filter by warehouse ID.
- **product_id** (string) - Optional - Filter by product ID.

### Response
#### Success Response (200)
- **inventory** (array) - A list of inventory items.
  - **product_id** (string) - The ID of the product.
  - **warehouse_id** (string) - The ID of the warehouse.
  - **quantity** (number) - The quantity of the product in stock.

#### Response Example
```json
{
  "inventory": [
    {"product_id": "prodA", "warehouse_id": "wh1", "quantity": 1000},
    {"product_id": "prodB", "warehouse_id": "wh1", "quantity": 500}
  ]
}
```
```

--------------------------------

### License Information API

Source: https://qdc-partner-support.imagelinenetwork.com/docs/index

Retrieves license information.

```APIDOC
## GET /license

### Description
Retrieves detailed information about the license associated with the API key or credentials.

### Method
GET

### Endpoint
/license

### Parameters
None

### Response
#### Success Response (200)
- **license_details** (object) - An object containing various license details.
  - **plan_name** (string) - The name of the license plan.
  - **expiration_date** (string) - The date when the license expires.
  - **features** (array) - A list of features included in the license.

#### Response Example
```json
{
  "license_details": {
    "plan_name": "Premium",
    "expiration_date": "2024-12-31",
    "features": ["feature1", "feature2"]
  }
}
```
```

--------------------------------

### Dictionaries API

Source: https://qdc-partner-support.imagelinenetwork.com/docs/index

Provides access to various dictionaries used within the QdC system.

```APIDOC
## GET /dizionari/colture/{tipo_coltura}

### Description
Retrieves a list of crops based on the specified type.

### Method
GET

### Endpoint
/dizionari/colture/{tipo_coltura}

### Parameters
#### Path Parameters
- **tipo_coltura** (string) - Required - The type of crop to filter by (e.g., 'frutta', 'verdura').

### Response
#### Success Response (200)
- **crops** (array) - A list of crop objects.
  - **id** (string) - The unique identifier for the crop.
  - **name** (string) - The name of the crop.

#### Response Example
```json
{
  "crops": [
    {"id": "c101", "name": "Apple"},
    {"id": "c102", "name": "Pear"}
  ]
}
```
```

```APIDOC
## GET /dizionari/operazioni

### Description
Retrieves a list of operations available in the system.

### Method
GET

### Endpoint
/dizionari/operazioni

### Parameters
None

### Response
#### Success Response (200)
- **operations** (array) - A list of operation objects.
  - **id** (string) - The unique identifier for the operation.
  - **name** (string) - The name of the operation.

#### Response Example
```json
{
  "operations": [
    {"id": "op1", "name": "Planting"},
    {"id": "op2", "name": "Harvesting"}
  ]
}
```
```

```APIDOC
## GET /dizionari/condizioni_climatiche

### Description
Retrieves a list of climatic conditions.

### Method
GET

### Endpoint
/dizionari/condizioni_climatiche

### Parameters
None

### Response
#### Success Response (200)
- **climatic_conditions** (array) - A list of climatic condition objects.
  - **id** (string) - The unique identifier for the climatic condition.
  - **name** (string) - The name of the climatic condition.

#### Response Example
```json
{
  "climatic_conditions": [
    {"id": "cc1", "name": "Sunny"},
    {"id": "cc2", "name": "Rainy"}
  ]
}
```
```

```APIDOC
## GET /dizionari/mezzi_tecnici

### Description
Retrieves a list of technical means and their units of measure.

### Method
GET

### Endpoint
/dizionari/mezzi_tecnici

### Parameters
None

### Response
#### Success Response (200)
- **technical_means** (array) - A list of technical means objects.
  - **id** (string) - The unique identifier for the technical mean.
  - **name** (string) - The name of the technical mean.
  - **unit_of_measure** (string) - The unit of measure for the technical mean.

#### Response Example
```json
{
  "technical_means": [
    {"id": "tm1", "name": "Tractor", "unit_of_measure": "hours"},
    {"id": "tm2", "name": "Fertilizer", "unit_of_measure": "kg"}
  ]
}
```
```

--------------------------------

### QdC Notifications API

Source: https://qdc-partner-support.imagelinenetwork.com/docs/index

Manages notifications within the QdC system, specifically for interventions.

```APIDOC
## POST /qdc/interventi/notifiche/crea_notifica

### Description
Creates a new notification related to an intervention in the QdC system.

### Method
POST

### Endpoint
/qdc/interventi/notifiche/crea_notifica

### Parameters
#### Request Body
- **intervention_id** (string) - Required - The ID of the intervention to which the notification is related.
- **message** (string) - Required - The content of the notification message.
- **recipient** (string) - Optional - The intended recipient of the notification.

### Request Example
```json
{
  "intervention_id": "int1",
  "message": "Fertilization completed successfully.",
  "recipient": "farm_manager@example.com"
}
```

### Response
#### Success Response (200)
- **notification_id** (string) - The unique identifier for the created notification.
- **status** (string) - The status of the notification creation (e.g., 'success').

#### Response Example
```json
{
  "notification_id": "notif987",
  "status": "success"
}
```
```

--------------------------------

### Technical Searches API

Source: https://qdc-partner-support.imagelinenetwork.com/docs/index

Provides endpoints for searching various technical agricultural means.

```APIDOC
## GET /ricerca/fertilizzanti

### Description
Searches for fertilizers available in the system.

### Method
GET

### Endpoint
/ricerca/fertilizzanti

### Parameters
#### Query Parameters
- **query** (string) - Optional - Search term for fertilizers.

### Response
#### Success Response (200)
- **results** (array) - A list of fertilizer objects.
  - **id** (string) - The unique identifier for the fertilizer.
  - **name** (string) - The name of the fertilizer.

#### Response Example
```json
{
  "results": [
    {"id": "f1", "name": "Nitrogen Fertilizer"},
    {"id": "f2", "name": "Phosphate Fertilizer"}
  ]
}
```
```

```APIDOC
## GET /ricerca/piantine

### Description
Searches for seedlings available in the system.

### Method
GET

### Endpoint
/ricerca/piantine

### Parameters
#### Query Parameters
- **query** (string) - Optional - Search term for seedlings.

### Response
#### Success Response (200)
- **results** (array) - A list of seedling objects.
  - **id** (string) - The unique identifier for the seedling.
  - **name** (string) - The name of the seedling.

#### Response Example
```json
{
  "results": [
    {"id": "p1", "name": "Tomato Seedling"},
    {"id": "p2", "name": "Pepper Seedling"}
  ]
}
```
```

```APIDOC
## GET /ricerca/sementi

### Description
Searches for seeds available in the system.

### Method
GET

### Endpoint
/ricerca/sementi

### Parameters
#### Query Parameters
- **query** (string) - Optional - Search term for seeds.

### Response
#### Success Response (200)
- **results** (array) - A list of seed objects.
  - **id** (string) - The unique identifier for the seed.
  - **name** (string) - The name of the seed.

#### Response Example
```json
{
  "results": [
    {"id": "s1", "name": "Corn Seeds"},
    {"id": "s2", "name": "Bean Seeds"}
  ]
}
```
```

```APIDOC
## GET /ricerca/ausiliari

### Description
Searches for auxiliary agents available in the system.

### Method
GET

### Endpoint
/ricerca/ausiliari

### Parameters
#### Query Parameters
- **query** (string) - Optional - Search term for auxiliary agents.

### Response
#### Success Response (200)
- **results** (array) - A list of auxiliary agent objects.
  - **id** (string) - The unique identifier for the auxiliary agent.
  - **name** (string) - The name of the auxiliary agent.

#### Response Example
```json
{
  "results": [
    {"id": "a1", "name": "Pesticide"},
    {"id": "a2", "name": "Herbicide"}
  ]
}
```
```

```APIDOC
## GET /ricerca/corroboranti

### Description
Searches for corroborating agents available in the system.

### Method
GET

### Endpoint
/ricerca/corroboranti

### Parameters
#### Query Parameters
- **query** (string) - Optional - Search term for corroborating agents.

### Response
#### Success Response (200)
- **results** (array) - A list of corroborating agent objects.
  - **id** (string) - The unique identifier for the corroborating agent.
  - **name** (string) - The name of the corroborating agent.

#### Response Example
```json
{
  "results": [
    {"id": "c1", "name": "Biostimulant"},
    {"id": "c2", "name": "Adjuvant"}
  ]
}
```
```

```APIDOC
## GET /ricerca/sostanze_di_base

### Description
Searches for base substances available in the system.

### Method
GET

### Endpoint
/ricerca/sostanze_di_base

### Parameters
#### Query Parameters
- **query** (string) - Optional - Search term for base substances.

### Response
#### Success Response (200)
- **results** (array) - A list of base substance objects.
  - **id** (string) - The unique identifier for the base substance.
  - **name** (string) - The name of the base substance.

#### Response Example
```json
{
  "results": [
    {"id": "sb1", "name": "Nitrogen"},
    {"id": "sb2", "name": "Phosphorus"}
  ]
}
```
```
Tokens:
Raw