Scheda dell'endpoint

POST /1.0/pickups/{token}/create

Create pickup

Pickups POST

Endpoint

Scegli l'ambiente e l'indirizzo cambia con lui.

http://173.249.30.252/spedireweb/api/1.0/pickups/{token}/create

Richiesta

Quelli segnati come necessari non si possono omettere.

4
Nome Dove Tipo Serve Descrizione
Authorization header string Sì Bearer access token. Example: Bearer <TOKEN>.
Accept header string Sì Expected response format.
Content-Type header string No Request body format when a JSON body is sent.
token path string Sì
Authorization Serve
header string

Bearer access token. Example: Bearer <TOKEN>.

Accept Serve
header string

Expected response format.

Content-Type
header string

Request body format when a JSON body is sent.

token Serve
path string

Esempio richiesta

Metti il tuo token dove c'è scritto TOKEN.

cURL
curl -X POST "http://173.249.30.252/spedireweb/api/1.0/pickups/{token}/create" \
     -H "Authorization: Bearer <TOKEN>" \
     -H "Accept: application/json" \
     -H "Content-Type: application/json" \
     -d '{\"date\":\"2026-09-28\",\"details\":{\"city\":1,\"phone\":\"+390000000000\",\"address\":\"Via Roma\",\"last_name\":\"Rossi\"},\"time_slot\":1}'

Corpo richiesta

{
    "date": "2026-09-28",
    "details": {
        "city": 1,
        "phone": "+390000000000",
        "address": "Via Roma",
        "last_name": "Rossi"
    },
    "time_slot": 1
}

Risposta

Un blocco per ogni risposta che l'endpoint può dare.

8

{
    "success": true
}

{
    "error": {
        "code": "REQUEST_1001",
        "message": "Invalid request."
    },
    "success": false,
    "request_id": "req_01k5example000000000000000"
}

{
    "error": {
        "code": "AUTH_1001",
        "message": "Authentication required."
    },
    "success": false,
    "request_id": "req_01k5example000000000000000"
}

{
    "error": {
        "code": "AUTH_1003",
        "message": "Permission denied."
    },
    "success": false,
    "request_id": "req_01k5example000000000000000"
}

{
    "error": {
        "code": "APP_1004",
        "message": "Resource not found."
    },
    "success": false,
    "request_id": "req_01k5example000000000000000"
}

{
    "error": {
        "code": "VALIDATION_1001",
        "message": "Validation failed."
    },
    "success": false,
    "request_id": "req_01k5example000000000000000"
}

{
    "error": {
        "code": "RATE_LIMIT_1001",
        "message": "Too many requests."
    },
    "success": false,
    "request_id": "req_01k5example000000000000000"
}

{
    "error": {
        "code": "SERVER_1001",
        "message": "Internal server error."
    },
    "success": false,
    "request_id": "req_01k5example000000000000000"
}

Da sapere

Creates a courier pickup for an owned shipment token. Requires a Bearer access token.