Torna alla lista

Collegamento — rifiuta v1

Rifiuta un collegamento proposto (stato 1→3). Stessa logica di autorizzazione di collegamento_approva. È possibile allegare una motivazione.

Endpoint

POST /api/v1/collegamento_rifiuta/{id}

Autenticazione

Autenticazione: x-api-key

Ogni richiesta deve includere la chiave API nell'header HTTP X-API-Key.

X-API-Key: <api_key>

Se la chiave è assente o non valida l'API risponde con HTTP 401.

Parametri

Parametro Tipo Obbligatorio Descrizione
id integer Obbligatorio ID del collegamento (segmento path).
motivo string Opzionale Motivazione del rifiuto. Salvata come nota interna, non visibile pubblicamente.

Note

  • Restituisce 403 se la piattaforma autenticata non è il destinatario del collegamento.
  • I collegamenti rifiutati rimangono nel DB con stato=3 e non sono visibili pubblicamente.
  • Un collegamento rifiutato può essere riproposto: la proposta sarà trattata come nuova se lo stato precedente era Rifiutata.

Esempio richiesta

POST https://lexiper.it/api/v1/collegamento_rifiuta/16
X-API-Key: {api_key_inbound}
Content-Type: application/x-www-form-urlencoded

motivo=Il+luogo+indicato+non+corrisponde

Esempio risposta

{
    "status": "success",
    "data": {
        "id": 16,
        "stato": 3,
        "msg": "Collegamento rifiutato."
    }
}

Errore 401

HTTP Status: 401

Autenticazione fallita