API · Appuntamenti e prenotazioni

Collega la tua agenda a SellViaApp.

Gestisci servizi, risorse, orari, indisponibilità, fasce e prenotazioni dal tuo software.

URL della basehttps://api.sellviaapp.com/

Required headersX-API-Key + Bearer

Developer supportapi@sellviaapp.com

Avvio rapido

Authenticate, choose a route, test.

Get the X-API-Key and generate the Bearer in Dashboard → API. Enter them below, then use “Test · Generate” on an endpoint to obtain the response and cURL, PHP 8 or JavaScript code.

X-API-Key

Bearer token

Credentials incompleteEnter the X-API-Key and Bearer token to prepare a test.

Credentials remain in memory for this page only. For a customer-related operation, add customer_id.

Keep in mindHTTPS + JSON · keep both credentials server-side · never send tokens to support.

Punti di fine

Appointments & bookings

Configure services, resources, schedules and bookings from the mobile app, an ERP or business software.

33 routes

GET /booking/config/get Chiave + Cuscinetto

Read booking rules and the app currency.

Input

Available parameters

URL query

No business parameter is expected. Send only the indicated authentication headers.

Output

Possible results

200Successful operation

400Invalid request or JSON

401Missing or invalid authentication

403Insufficient access

404Requested resource not found

409Conflict with existing data

422Parameter rejected by validation

429Request limit reached

5xxxxTemporary technical incident

Success example

{
    "success": true,
    "message": "Operation successful",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Error example

{
    "success": false,
    "message": "The request cannot be processed.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Check the indicated parameters.",
        "details": {
            "field": "parameter_name"
        }
    }
}

PATCH /booking/config/update Chiave + Cuscinetto

Update notice, cancellation and reminder rules. Two-step confirmation always remains active.

Input

Available parameters

Corpo JSON

NomeTipo diRequirementDesignazione delle merci

min_notice_minutes Integer Optional

Minimum booking notice.

max_advance_days Integer Optional

Maximum advance booking days.

cancellation_hours Integer Optional

Customer cancellation deadline.

public_booking boolean Optional

Allow mobile booking.

reminders_enabled boolean Optional

Enable the reminder queue.

reminder_hours Integer Optional

Hours before the booking.

customer_notes_enabled boolean Optional

Allow customer notes.

Output

Possible results

200Successful operation

400Invalid request or JSON

401Missing or invalid authentication

403Insufficient access

404Requested resource not found

409Conflict with existing data

422Parameter rejected by validation

429Request limit reached

5xxxxTemporary technical incident

Success example

{
    "success": true,
    "message": "Operation successful",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Error example

{
    "success": false,
    "message": "The request cannot be processed.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Check the indicated parameters.",
        "details": {
            "field": "parameter_name"
        }
    }
}

GET /booking/service-category/list Chiave + Cuscinetto

List service categories and subcategories.

Input

URL query

No business parameter is expected. Send only the indicated authentication headers.

Output

200Successful operation

400Invalid request or JSON

401Missing or invalid authentication

403Insufficient access

404Requested resource not found

409Conflict with existing data

422Parameter rejected by validation

429Request limit reached

5xxxxTemporary technical incident

Success example

{
    "success": true,
    "message": "Operation successful",
    "data": {
        "items": [],
        "pagination": {
            "page": 1,
            "per_page": 25,
            "total": 0,
            "last_page": 1
        }
    },
    "error": null
}

Error example

{
    "success": false,
    "message": "The request cannot be processed.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Check the indicated parameters.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /booking/service-category/add Chiave + Cuscinetto

Create a main category or subcategory.

Input

Available parameters

Corpo JSON

NomeTipo diRequirementDesignazione delle merci

name stringa Obbligatorio

Category name.

parent_id Integer Optional

Main category identifier when creating a subcategory.

description stringa Optional

Optional description.

color hex Optional

#RRGGBB

photo_base64 stringa Optional

Single JPG, PNG or WebP photo as base64 or data URI.

photo_file_name stringa Optional

Optional file name.

photo_mime_type stringa Optional

image/jpeg | image/png | image/webp

active boolean Optional

Visible in the app.

sort_order Integer Optional

Display order.

Output

Possible results

201Resource created

400Invalid request or JSON

401Missing or invalid authentication

403Insufficient access

404Requested resource not found

409Conflict with existing data

422Parameter rejected by validation

429Request limit reached

5xxxxTemporary technical incident

Success example

{
    "success": true,
    "message": "Operation successful",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Error example

{
    "success": false,
    "message": "The request cannot be processed.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Check the indicated parameters.",
        "details": {
            "field": "parameter_name"
        }
    }
}

PATCH /booking/service-category/update Chiave + Cuscinetto

Update a service category classification.

Input

Available parameters

Corpo JSON

NomeTipo diRequirementDesignazione delle merci

id Integer Obbligatorio

Category to update.

name stringa Obbligatorio

Name.

parent_id Integer Optional

0 for a main category.

photo_base64 stringa Optional

A new photo replaces the current photo.

remove_photo boolean Optional

Remove the current photo.

Output

Possible results

200Successful operation

400Invalid request or JSON

401Missing or invalid authentication

403Insufficient access

404Requested resource not found

409Conflict with existing data

422Parameter rejected by validation

429Request limit reached

5xxxxTemporary technical incident

Success example

{
    "success": true,
    "message": "Operation successful",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Error example

{
    "success": false,
    "message": "The request cannot be processed.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Check the indicated parameters.",
        "details": {
            "field": "parameter_name"
        }
    }
}

DELETE /booking/service-category/delete Chiave + Cuscinetto

Delete an unused category or archive it.

Input

Available parameters

Corpo JSON

NomeTipo diRequirementDesignazione delle merci

id Integer Obbligatorio

A used category will be archived.

Output

Possible results

200Successful operation

400Invalid request or JSON

401Missing or invalid authentication

403Insufficient access

404Requested resource not found

409Conflict with existing data

422Parameter rejected by validation

429Request limit reached

5xxxxTemporary technical incident

Success example

{
    "success": true,
    "message": "Operation successful",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Error example

{
    "success": false,
    "message": "The request cannot be processed.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Check the indicated parameters.",
        "details": {
            "field": "parameter_name"
        }
    }
}

GET /booking/service/list Chiave + Cuscinetto

List bookable services and eligible resources.

Input

Available parameters

URL query

No business parameter is expected. Send only the indicated authentication headers.

Output

Possible results

200Successful operation

400Invalid request or JSON

401Missing or invalid authentication

403Insufficient access

404Requested resource not found

409Conflict with existing data

422Parameter rejected by validation

429Request limit reached

5xxxxTemporary technical incident

Success example

{
    "success": true,
    "message": "Operation successful",
    "data": {
        "items": [],
        "pagination": {
            "page": 1,
            "per_page": 25,
            "total": 0,
            "last_page": 1
        }
    },
    "error": null
}

Error example

{
    "success": false,
    "message": "The request cannot be processed.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Check the indicated parameters.",
        "details": {
            "field": "parameter_name"
        }
    }
}

GET /booking/service/detail Chiave + Cuscinetto

Retrieve a service detailed description and photo gallery.

Input

Available parameters

URL query

NomeTipo diRequirementDesignazione delle merci

service_id Integer Obbligatorio

Service identifier.

Output

Possible results

200Successful operation

400Invalid request or JSON

401Missing or invalid authentication

403Insufficient access

404Requested resource not found

409Conflict with existing data

422Parameter rejected by validation

429Request limit reached

5xxxxTemporary technical incident

Success example

{
    "success": true,
    "message": "Operation successful",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Error example

{
    "success": false,
    "message": "The request cannot be processed.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Check the indicated parameters.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /booking/service/add Chiave + Cuscinetto

Create a service with duration, price and resources.

Input

Available parameters

Corpo JSON

NomeTipo diRequirementDesignazione delle merci

name stringa Obbligatorio

Service name.

category_id Integer Optional

Main category.

subcategory_id Integer Optional

Subcategory belonging to category_id.

short_description stringa Optional

Short text shown below the title in the mobile list.

long_description stringa Optional

Detailed presentation shown on the service page.

booking_mode enumera Optional

appointment | duration | period | capacity

duration_minutes Integer Optional

Actual booking duration, from 5 to 10080 minutes.

slot_interval_minutes Integer Optional

Start-time frequency. 0 or omitted = same as duration_minutes.

capacity_required Integer Optional

Capacity consumed by one booking.

price_type enumera Optional

free | fixed | hourly | daily

price decimale Optional

Price in the app currency.

deposit_type enumera Optional

none | fixed | percent

deposit_value decimale Optional

Amount or percentage.

location_mode enumera Optional

business | customer | online | custom

address_required boolean Optional

Require customer address.

resource_ids array Obbligatorio

Eligible resource identifiers.

active boolean Optional

Visible service.

sort_order Integer Optional

Display order.

Output

Possible results

201Resource created

400Invalid request or JSON

401Missing or invalid authentication

403Insufficient access

404Requested resource not found

409Conflict with existing data

422Parameter rejected by validation

429Request limit reached

5xxxxTemporary technical incident

Success example

{
    "success": true,
    "message": "Operation successful",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Error example

{
    "success": false,
    "message": "The request cannot be processed.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Check the indicated parameters.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /booking/service/photo/add Chiave + Cuscinetto

Add a photo to a service gallery.

Input

Available parameters

Corpo JSON

NomeTipo diRequirementDesignazione delle merci

service_id Integer Obbligatorio

Service identifier.

photo_base64 stringa Obbligatorio

JPG, PNG or WebP image as base64 or data URI.

file_name stringa Optional

File name.

mime_type stringa Optional

image/jpeg | image/png | image/webp

Output

Possible results

201Resource created

400Invalid request or JSON

401Missing or invalid authentication

403Insufficient access

404Requested resource not found

409Conflict with existing data

422Parameter rejected by validation

429Request limit reached

5xxxxTemporary technical incident

Success example

{
    "success": true,
    "message": "Operation successful",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Error example

{
    "success": false,
    "message": "The request cannot be processed.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Check the indicated parameters.",
        "details": {
            "field": "parameter_name"
        }
    }
}

DELETE /booking/service/photo/delete Chiave + Cuscinetto

Delete a service photo.

Input

Available parameters

Corpo JSON

NomeTipo diRequirementDesignazione delle merci

service_id Integer Obbligatorio

Service identifier.

photo_id Integer Obbligatorio

Photo to delete.

Output

Possible results

200Successful operation

400Invalid request or JSON

401Missing or invalid authentication

403Insufficient access

404Requested resource not found

409Conflict with existing data

422Parameter rejected by validation

429Request limit reached

5xxxxTemporary technical incident

Success example

{
    "success": true,
    "message": "Operation successful",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Error example

{
    "success": false,
    "message": "The request cannot be processed.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Check the indicated parameters.",
        "details": {
            "field": "parameter_name"
        }
    }
}

PATCH /booking/service/photo/primary Chiave + Cuscinetto

Select the main photo shown in the mobile list.

Input

Available parameters

Corpo JSON

NomeTipo diRequirementDesignazione delle merci

service_id Integer Obbligatorio

Service identifier.

photo_id Integer Obbligatorio

Photo used in the mobile list.

Output

Possible results

200Successful operation

400Invalid request or JSON

401Missing or invalid authentication

403Insufficient access

404Requested resource not found

409Conflict with existing data

422Parameter rejected by validation

429Request limit reached

5xxxxTemporary technical incident

Success example

{
    "success": true,
    "message": "Operation successful",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Error example

{
    "success": false,
    "message": "The request cannot be processed.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Check the indicated parameters.",
        "details": {
            "field": "parameter_name"
        }
    }
}

PATCH /booking/service/update Chiave + Cuscinetto

Update a bookable service.

Input

Available parameters

Corpo JSON

NomeTipo diRequirementDesignazione delle merci

id Integer Obbligatorio

Service identifier.

name stringa Obbligatorio

Service name.

duration_minutes Integer Optional

Actual booking duration.

slot_interval_minutes Integer Optional

Start-time frequency; 0 uses the service duration.

category_id Integer Optional

Main category.

subcategory_id Integer Optional

Subcategory.

resource_ids array Optional

Complete eligible-resource list.

Output

Possible results

200Successful operation

400Invalid request or JSON

401Missing or invalid authentication

403Insufficient access

404Requested resource not found

409Conflict with existing data

422Parameter rejected by validation

429Request limit reached

5xxxxTemporary technical incident

Success example

{
    "success": true,
    "message": "Operation successful",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Error example

{
    "success": false,
    "message": "The request cannot be processed.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Check the indicated parameters.",
        "details": {
            "field": "parameter_name"
        }
    }
}

DELETE /booking/service/delete Chiave + Cuscinetto

Delete an unused service or archive it.

Input

Available parameters

Corpo JSON

NomeTipo diRequirementDesignazione delle merci

id Integer Obbligatorio

A used service will be archived.

Output

Possible results

200Successful operation

400Invalid request or JSON

401Missing or invalid authentication

403Insufficient access

404Requested resource not found

409Conflict with existing data

422Parameter rejected by validation

429Request limit reached

5xxxxTemporary technical incident

Success example

{
    "success": true,
    "message": "Operation successful",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Error example

{
    "success": false,
    "message": "The request cannot be processed.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Check the indicated parameters.",
        "details": {
            "field": "parameter_name"
        }
    }
}

GET /booking/resource/list Chiave + Cuscinetto

List people, rooms, vehicles, equipment and capacity resources.

Input

Available parameters

URL query

No business parameter is expected. Send only the indicated authentication headers.

Output

Possible results

200Successful operation

400Invalid request or JSON

401Missing or invalid authentication

403Insufficient access

404Requested resource not found

409Conflict with existing data

422Parameter rejected by validation

429Request limit reached

5xxxxTemporary technical incident

Success example

{
    "success": true,
    "message": "Operation successful",
    "data": {
        "items": [],
        "pagination": {
            "page": 1,
            "per_page": 25,
            "total": 0,
            "last_page": 1
        }
    },
    "error": null
}

Error example

{
    "success": false,
    "message": "The request cannot be processed.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Check the indicated parameters.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /booking/resource/add Chiave + Cuscinetto

Create a bookable resource.

Input

Available parameters

Corpo JSON

NomeTipo diRequirementDesignazione delle merci

name stringa Obbligatorio

Resource name.

resource_type enumera Optional

description stringa Optional

Resource description.

capacity Integer Optional

Concurrent capacity.

location stringa Optional

Associated location.

color hex Optional

#RRGGBB

active boolean Optional

Active resource.

sort_order Integer Optional

Order.

Output

Possible results

201Resource created

400Invalid request or JSON

401Missing or invalid authentication

403Insufficient access

404Requested resource not found

409Conflict with existing data

422Parameter rejected by validation

429Request limit reached

5xxxxTemporary technical incident

Success example

{
    "success": true,
    "message": "Operation successful",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Error example

{
    "success": false,
    "message": "The request cannot be processed.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Check the indicated parameters.",
        "details": {
            "field": "parameter_name"
        }
    }
}

PATCH /booking/resource/update Chiave + Cuscinetto

Update a resource.

Input

Available parameters

Corpo JSON

NomeTipo diRequirementDesignazione delle merci

id Integer Obbligatorio

Resource identifier.

name stringa Obbligatorio

Name.

capacity Integer Optional

Concurrent capacity.

Output

Possible results

200Successful operation

400Invalid request or JSON

401Missing or invalid authentication

403Insufficient access

404Requested resource not found

409Conflict with existing data

422Parameter rejected by validation

429Request limit reached

5xxxxTemporary technical incident

Success example

{
    "success": true,
    "message": "Operation successful",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Error example

{
    "success": false,
    "message": "The request cannot be processed.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Check the indicated parameters.",
        "details": {
            "field": "parameter_name"
        }
    }
}

DELETE /booking/resource/delete Chiave + Cuscinetto

Delete an unused resource or archive it.

Input

Available parameters

Corpo JSON

NomeTipo diRequirementDesignazione delle merci

id Integer Obbligatorio

A used resource will be archived.

Output

Possible results

200Successful operation

400Invalid request or JSON

401Missing or invalid authentication

403Insufficient access

404Requested resource not found

409Conflict with existing data

422Parameter rejected by validation

429Request limit reached

5xxxxTemporary technical incident

Success example

{
    "success": true,
    "message": "Operation successful",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Error example

{
    "success": false,
    "message": "The request cannot be processed.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Check the indicated parameters.",
        "details": {
            "field": "parameter_name"
        }
    }
}

GET /booking/availability/list Chiave + Cuscinetto

List weekly schedules.

Input

Available parameters

URL query

No business parameter is expected. Send only the indicated authentication headers.

Output

Possible results

200Successful operation

400Invalid request or JSON

401Missing or invalid authentication

403Insufficient access

404Requested resource not found

409Conflict with existing data

422Parameter rejected by validation

429Request limit reached

5xxxxTemporary technical incident

Success example

{
    "success": true,
    "message": "Operation successful",
    "data": {
        "items": [],
        "pagination": {
            "page": 1,
            "per_page": 25,
            "total": 0,
            "last_page": 1
        }
    },
    "error": null
}

Error example

{
    "success": false,
    "message": "The request cannot be processed.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Check the indicated parameters.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /booking/availability/add Chiave + Cuscinetto

Add a general, service-specific or resource-specific schedule.

Input

Available parameters

Corpo JSON

NomeTipo diRequirementDesignazione delle merci

service_id Integer Optional

Target service; omit or use 0 for all services.

resource_id Integer Optional

Target resource; omit or use 0 for all eligible resources.

weekday Integer Obbligatorio

1 Monday to 7 Sunday.

start_time time Obbligatorio

HH:MM

end_time time Obbligatorio

HH:MM

Output

Possible results

201Resource created

400Invalid request or JSON

401Missing or invalid authentication

403Insufficient access

404Requested resource not found

409Conflict with existing data

422Parameter rejected by validation

429Request limit reached

5xxxxTemporary technical incident

Success example

{
    "success": true,
    "message": "Operation successful",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Error example

{
    "success": false,
    "message": "The request cannot be processed.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Check the indicated parameters.",
        "details": {
            "field": "parameter_name"
        }
    }
}

DELETE /booking/availability/delete Chiave + Cuscinetto

Delete a schedule.

Input

Available parameters

Corpo JSON

NomeTipo diRequirementDesignazione delle merci

id Integer Obbligatorio

Schedule identifier.

Output

Possible results

200Successful operation

400Invalid request or JSON

401Missing or invalid authentication

403Insufficient access

404Requested resource not found

409Conflict with existing data

422Parameter rejected by validation

429Request limit reached

5xxxxTemporary technical incident

Success example

{
    "success": true,
    "message": "Operation successful",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Error example

{
    "success": false,
    "message": "The request cannot be processed.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Check the indicated parameters.",
        "details": {
            "field": "parameter_name"
        }
    }
}

GET /booking/unavailability/list Chiave + Cuscinetto

List holidays, closures and blocked periods.

Input

Available parameters

URL query

No business parameter is expected. Send only the indicated authentication headers.

Output

Possible results

200Successful operation

400Invalid request or JSON

401Missing or invalid authentication

403Insufficient access

404Requested resource not found

409Conflict with existing data

422Parameter rejected by validation

429Request limit reached

5xxxxTemporary technical incident

Success example

{
    "success": true,
    "message": "Operation successful",
    "data": {
        "items": [],
        "pagination": {
            "page": 1,
            "per_page": 25,
            "total": 0,
            "last_page": 1
        }
    },
    "error": null
}

Error example

{
    "success": false,
    "message": "The request cannot be processed.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Check the indicated parameters.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /booking/unavailability/add Chiave + Cuscinetto

Block a general or resource-specific period.

Input

Available parameters

Corpo JSON

NomeTipo diRequirementDesignazione delle merci

resource_id Integer Optional

Omit to block the entire business.

starts_at datetime Obbligatorio

ISO 8601 with timezone recommended.

ends_at datetime Obbligatorio

After starts_at.

reason stringa Optional

Optional reason.

Output

Possible results

201Resource created

400Invalid request or JSON

401Missing or invalid authentication

403Insufficient access

404Requested resource not found

409Conflict with existing data

422Parameter rejected by validation

429Request limit reached

5xxxxTemporary technical incident

Success example

{
    "success": true,
    "message": "Operation successful",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Error example

{
    "success": false,
    "message": "The request cannot be processed.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Check the indicated parameters.",
        "details": {
            "field": "parameter_name"
        }
    }
}

DELETE /booking/unavailability/delete Chiave + Cuscinetto

Delete an unavailability.

Input

Available parameters

Corpo JSON

NomeTipo diRequirementDesignazione delle merci

id Integer Obbligatorio

Period identifier.

Output

Possible results

200Successful operation

400Invalid request or JSON

401Missing or invalid authentication

403Insufficient access

404Requested resource not found

409Conflict with existing data

422Parameter rejected by validation

429Request limit reached

5xxxxTemporary technical incident

Success example

{
    "success": true,
    "message": "Operation successful",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Error example

{
    "success": false,
    "message": "The request cannot be processed.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Check the indicated parameters.",
        "details": {
            "field": "parameter_name"
        }
    }
}

GET /booking/slot/list Chiave + Cuscinetto

List available slots and slots temporarily pending administrator confirmation.

Input

Available parameters

URL query

NomeTipo diRequirementDesignazione delle merci

service_id Integer Obbligatorio

Bookable service.

resource_id Integer Optional

Limit to one resource.

from_date data Optional

YYYYY-MM-DD

days Integer Optional

1 - 31

Output

Possible results

200Successful operation

400Invalid request or JSON

401Missing or invalid authentication

403Insufficient access

404Requested resource not found

409Conflict with existing data

422Parameter rejected by validation

429Request limit reached

5xxxxTemporary technical incident

Success example

{
    "success": true,
    "message": "Operation successful",
    "data": {
        "items": [],
        "pagination": {
            "page": 1,
            "per_page": 25,
            "total": 0,
            "last_page": 1
        }
    },
    "error": null
}

Error example

{
    "success": false,
    "message": "The request cannot be processed.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Check the indicated parameters.",
        "details": {
            "field": "parameter_name"
        }
    }
}

GET /booking/list Chiave + Cuscinetto

List authorised bookings.

Input

Available parameters

URL query

NomeTipo diRequirementDesignazione delle merci

status enumera Optional

limit Integer Optional

1 - 200

Output

Possible results

200Successful operation

400Invalid request or JSON

401Missing or invalid authentication

403Insufficient access

404Requested resource not found

409Conflict with existing data

422Parameter rejected by validation

429Request limit reached

5xxxxTemporary technical incident

Success example

{
    "success": true,
    "message": "Operation successful",
    "data": {
        "items": [],
        "pagination": {
            "page": 1,
            "per_page": 25,
            "total": 0,
            "last_page": 1
        }
    },
    "error": null
}

Error example

{
    "success": false,
    "message": "The request cannot be processed.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Check the indicated parameters.",
        "details": {
            "field": "parameter_name"
        }
    }
}

GET /booking/detail Chiave + Cuscinetto

Retrieve one booking and its history.

Input

Available parameters

URL query

NomeTipo diRequirementDesignazione delle merci

id Integer Obbligatorio

Booking identifier.

Output

Possible results

200Successful operation

400Invalid request or JSON

401Missing or invalid authentication

403Insufficient access

404Requested resource not found

409Conflict with existing data

422Parameter rejected by validation

429Request limit reached

5xxxxTemporary technical incident

Success example

{
    "success": true,
    "message": "Operation successful",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Error example

{
    "success": false,
    "message": "The request cannot be processed.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Check the indicated parameters.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /booking/create Chiave + Cuscinetto

Create and confirm the customer request; administrator approval is then still required.

Input

Available parameters

Corpo JSON

NomeTipo diRequirementDesignazione delle merci

service_id Integer Obbligatorio

Selected service.

resource_id Integer Obbligatorio

Selected resource.

starts_at datetime Obbligatorio

Slot returned by booking/slot/list.

quantity Integer Optional

Capacity used.

address stringa Optional

Required depending on the service.

customer_notes stringa Optional

Optional note.

customer_id Integer Optional

Supplier token only.

customer_name stringa Optional

Required when no customer is linked.

customer_email email Optional

Contact address.

customer_phone stringa Optional

Contact phone.

Output

Possible results

200Successful operation

400Invalid request or JSON

401Missing or invalid authentication

403Insufficient access

404Requested resource not found

409Conflict with existing data

422Parameter rejected by validation

429Request limit reached

5xxxxTemporary technical incident

Success example

{
    "success": true,
    "message": "Operation successful",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Error example

{
    "success": false,
    "message": "The request cannot be processed.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Check the indicated parameters.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /booking/customer-confirm Chiave + Cuscinetto

Confirm a booking on the customer side.

Input

Available parameters

Corpo JSON

NomeTipo diRequirementDesignazione delle merci

booking_id Integer Obbligatorio

Booking belonging to the signed-in customer.

Output

Possible results

200Successful operation

400Invalid request or JSON

401Missing or invalid authentication

403Insufficient access

404Requested resource not found

409Conflict with existing data

422Parameter rejected by validation

429Request limit reached

5xxxxTemporary technical incident

Success example

{
    "success": true,
    "message": "Operation successful",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Error example

{
    "success": false,
    "message": "The request cannot be processed.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Check the indicated parameters.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /booking/admin-confirm Chiave + Cuscinetto

Confirm, return to pending or reject the booking on the administrator side.

Input

Available parameters

Corpo JSON

NomeTipo diRequirementDesignazione delle merci

booking_id Integer Obbligatorio

Booking to review.

confirmation enumera Obbligatorio

pending | confirmed | rejected

Output

Possible results

200Successful operation

400Invalid request or JSON

401Missing or invalid authentication

403Insufficient access

404Requested resource not found

409Conflict with existing data

422Parameter rejected by validation

429Request limit reached

5xxxxTemporary technical incident

Success example

{
    "success": true,
    "message": "Operation successful",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Error example

{
    "success": false,
    "message": "The request cannot be processed.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Check the indicated parameters.",
        "details": {
            "field": "parameter_name"
        }
    }
}

PATCH /booking/update Chiave + Cuscinetto

Reschedule or update a booking.

Input

Available parameters

Corpo JSON

NomeTipo diRequirementDesignazione delle merci

id Integer Obbligatorio

Booking to update.

service_id Integer Obbligatorio

Service.

resource_id Integer Obbligatorio

Resource.

starts_at datetime Obbligatorio

New start.

Output

Possible results

200Successful operation

400Invalid request or JSON

401Missing or invalid authentication

403Insufficient access

404Requested resource not found

409Conflict with existing data

422Parameter rejected by validation

429Request limit reached

5xxxxTemporary technical incident

Success example

{
    "success": true,
    "message": "Operation successful",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Error example

{
    "success": false,
    "message": "The request cannot be processed.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Check the indicated parameters.",
        "details": {
            "field": "parameter_name"
        }
    }
}

PATCH /booking/status/update Chiave + Cuscinetto

Advance a booking that has already been confirmed by both sides.

Input

Available parameters

Corpo JSON

NomeTipo diRequirementDesignazione delle merci

id Integer Obbligatorio

Booking.

status enumera Obbligatorio

Output

Possible results

200Successful operation

400Invalid request or JSON

401Missing or invalid authentication

403Insufficient access

404Requested resource not found

409Conflict with existing data

422Parameter rejected by validation

429Request limit reached

5xxxxTemporary technical incident

Success example

{
    "success": true,
    "message": "Operation successful",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Error example

{
    "success": false,
    "message": "The request cannot be processed.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Check the indicated parameters.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /booking/cancel Chiave + Cuscinetto

Cancel according to the configured deadline.

Input

Available parameters

Corpo JSON

NomeTipo diRequirementDesignazione delle merci

booking_id Integer Obbligatorio

Authorised booking.

reason stringa Optional

Optional reason.

Output

Possible results

200Successful operation

400Invalid request or JSON

401Missing or invalid authentication

403Insufficient access

404Requested resource not found

409Conflict with existing data

422Parameter rejected by validation

429Request limit reached

5xxxxTemporary technical incident

Success example

{
    "success": true,
    "message": "Operation successful",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Error example

{
    "success": false,
    "message": "The request cannot be processed.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Check the indicated parameters.",
        "details": {
            "field": "parameter_name"
        }
    }
}

Punti di fine

Customer payments

Choose pay on delivery or open a secure Stripe payment, then retrieve its server-verified status.

4 routes

GET /payment/config Chiave + Cuscinetto

Retrieve the enabled Stripe payment methods and the Stripe account provider selected for the app.

Input

Available parameters

URL query

No business parameter is expected. Send only the indicated authentication headers.

Output

Possible results

200Successful operation

400Invalid request or JSON

401Missing or invalid authentication

403Insufficient access

404Requested resource not found

409Conflict with existing data

422Parameter rejected by validation

429Request limit reached

5xxxxTemporary technical incident

Success example

{
    "success": true,
    "message": "Operation successful",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Error example

{
    "success": false,
    "message": "The request cannot be processed.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Check the indicated parameters.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /payment/checkout/create Chiave + Cuscinetto

Create or resume a Stripe Checkout page for an unpaid order or booking owned by the signed-in customer. A still-changeable pay-on-delivery choice is safely replaced.

Input

Available parameters

Corpo JSON

NomeTipo diRequirementDesignazione delle merci

purpose_type enumera Obbligatorio

order | booking

purpose_id Integer Obbligatorio

Identifier of the confirmed order or customer-confirmed booking.

Output

Possible results

200Successful operation

400Invalid request or JSON

401Missing or invalid authentication

403Insufficient access

404Requested resource not found

409Conflict with existing data

422Parameter rejected by validation

429Request limit reached

5xxxxTemporary technical incident

Success example

{
    "success": true,
    "message": "Operation successful",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Error example

{
    "success": false,
    "message": "The request cannot be processed.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Check the indicated parameters.",
        "details": {
            "field": "parameter_name"
        }
    }
}

POST /payment/pay-later Chiave + Cuscinetto

Record pay on delivery or replace a still-open Stripe payment after its session is securely checked and expired.

Input

Available parameters

Corpo JSON

NomeTipo diRequirementDesignazione delle merci

purpose_type enumera Obbligatorio

order | booking

purpose_id Integer Obbligatorio

Authorised order or booking identifier.

Output

Possible results

200Successful operation

400Invalid request or JSON

401Missing or invalid authentication

403Insufficient access

404Requested resource not found

409Conflict with existing data

422Parameter rejected by validation

429Request limit reached

5xxxxTemporary technical incident

Success example

{
    "success": true,
    "message": "Operation successful",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Error example

{
    "success": false,
    "message": "The request cannot be processed.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Check the indicated parameters.",
        "details": {
            "field": "parameter_name"
        }
    }
}

GET /payment/status Chiave + Cuscinetto

Retrieve a payment status; only the signed Stripe webhook can confirm it as paid.

Input

Available parameters

URL query

NomeTipo diRequirementDesignazione delle merci

reference stringa Optional

SellViaApp payment reference. Otherwise provide purpose_type and purpose_id.

purpose_type enumera Optional

order | booking

purpose_id Integer Optional

Paid object identifier.

Output

Possible results

200Successful operation

400Invalid request or JSON

401Missing or invalid authentication

403Insufficient access

404Requested resource not found

409Conflict with existing data

422Parameter rejected by validation

429Request limit reached

5xxxxTemporary technical incident

Success example

{
    "success": true,
    "message": "Operation successful",
    "data": {
        "id": 123,
        "status": "ok"
    },
    "error": null
}

Error example

{
    "success": false,
    "message": "The request cannot be processed.",
    "data": null,
    "error": {
        "code": "VALIDATION_ERROR",
        "category": "validation",
        "message": "Check the indicated parameters.",
        "details": {
            "field": "parameter_name"
        }
    }
}

Reference

Responses and errors

Each row has a “Parameters and responses” button showing required or optional fields, possible statuses and JSON examples. An empty list means the resource is not populated yet, not that the endpoint is down.

400Richiesta non valida

401Autenticazione richiesta

403Accesso negato

404Risorse o percorso non trovato

409conflitto commerciale

422Mancato il mancato convalida

429Troppe richieste

5xxxxIncidenza tecnica

Area di lavoro API

Endpoint

GET

Parametri URLUn parametro per riga: nome=valore Corpo JSONModifica i valori di esempio prima del test.

Il codice generato contiene le credenziali inserite. Conservale sul server e non condividere mai uno screenshot senza oscurarle.

Risposta API