Torna alla lista

Collegamento — approva v1

Approva un collegamento proposto (stato 1→2). Solo la piattaforma destinataria può approvare: quella in posizione B se il proponente è in posizione A, e viceversa.

Endpoint

POST /api/v1/collegamento_approva/{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). Esempio: /api/v1/collegamento_approva/16

Note

  • Restituisce 403 se la piattaforma autenticata non è il destinatario del collegamento.
  • Restituisce 409 se il collegamento non è nello stato Proposta (stato=1).
  • Dopo l'approvazione il collegamento è visibile pubblicamente via GET /api/v1/collegamento.

Esempio richiesta

POST https://lexiper.it/api/v1/collegamento_approva/16
X-API-Key: {api_key_inbound}

Esempio risposta

{
    "status": "success",
    "data": {
        "id": 16,
        "stato": 2,
        "msg": "Collegamento approvato."
    }
}

Errore 401

HTTP Status: 401

Autenticazione fallita