Explore Autoprofile

`POST` /explore/autoprofile

Avvia un processo di autoprofilazione su una ricerca PLUS esistente. Invia i risultati a un webhook specificato. La response fornisce un URL per monitorare lo stato dell'autoprofilazione.

Request Body

Campo	Tipo	Descrizione
`searchContextId`	String	Identificativo della ricerca PLUS (formato GUID)
`webhookUrl`	String	URL (webhook) a cui verranno inviati i dati autoprofilati

Risposta 200

Campo	Tipo	Descrizione
`monitorUrl`	String	URL per monitorare lo stato dell'autoprofilazione

WebhookAutoprofileBody

Il webhook viene chiamato una volta per ogni azienda autoprofilata, man mano che il processo avanza. Durante l'esecuzione, ci si può aspettare tipicamente 1 o 2 chiamate al secondo quando l'autoprofile è in corso.

Field	Type	Description
`company`	Company	Oggetto azienda autoprofilata
`matchStatus`	MatchStatus	Stato del match (YES o MAYBE)
`matchReason`	MatchReason	Motivo del match (IT/EN, generato da AI)

MatchStatus (enum)

YES – Match certo
MAYBE – Match probabile

MatchReason

Field	Type	Description
`it`	String	Motivo in italiano
`en`	String	Motivo in inglese

MonitorStatusResponse

Field	Type	Description
`status`	String	Stato del processo (QUEUED, IN_PROGRESS, DONE)
`startTimestamp`	DateTime	Timestamp di inizio
`endTimestamp`	DateTime\|null	Timestamp di fine (null se non terminato)
`eta`	DateTime\|null	Stima di completamento (null se non disponibile)
`companies`	Company[]	Array di aziende autoprofilate

Esempio

{
  "monitorUrl": "https://api.matchplat.com/explore/autoprofile/status/123e4567-e89b-12d3-a456-426614174000"
}

Esempio chiamata curl

curl -X POST "/explore/autoprofile" \
  -H "x-api-key: <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "searchContextId": "b7e6a2c1-4f3d-4e2a-9c1a-2b3e4d5f6a7b",
    "webhookUrl": "https://webhook.site/your-uuid"
  }'

Altri codici

400 – Spiegazione dell'errore
{ "error": "searchContextId non valido o non di tipo PLUS" }

POST /explore/autoprofile