Il motore di matching Biagio è disponibile tramite API. Stiamo selezionando partner per le prime integrazioni pilota. Compila il modulo per richiedere accesso.

Richiedi accesso al motore di matching

Il motore di matching Biagio consente di individuare compatibilità tra beni, servizi o richieste tra più utenti.

Il servizio è disponibile tramite REST API e può essere integrato in piattaforme web, marketplace o CMS come WordPress.

Biagio Matching API

Biagio Matching API

POST /api/v1/match

Headers

Content-Type: application/json
X-API-KEY: YOUR_API_KEY

Descrizione

Il motore restituisce cicli di scambio multiutente. La modalità principale è Seed Mode: vengono restituiti solo i cicli che includono il record principale (seed).

Payload

{
  "seed": {
    "offer": "bicicletta",
    "request": "chitarra"
  },
  "dataset": [
    {"offer":"chitarra","request":"libro"},
    {"offer":"libro","request":"bicicletta"}
  ]
}

Risposta base

{
  "cycles": [
    [
      {"offer":"bicicletta","request":"chitarra"},
      {"offer":"chitarra","request":"libro"},
      {"offer":"libro","request":"bicicletta"}
    ]
  ]
}

Risposta avanzata (consigliata)

{
  "cycles": [...],
  "resolved": [
    [
      {
        "item":"aziendaA",
        "offer":"...",
        "request":"...",
        "gives_to":"aziendaB",
        "receives_from":"aziendaC"
      }
    ]
  ]
}

Il campo resolved descrive esplicitamente le relazioni tra i partecipanti (chi dà a chi), semplificando l'integrazione lato client.

Regole

Integrazione WordPress

Il motore può essere integrato facilmente in WordPress tramite chiamate API.

Funzione PHP

function biagio_match($seed, $dataset){

 $api_url = "https://tuodominio.com/api/v1/match";

 $response = wp_remote_post($api_url, array(
  'headers' => array(
   'Content-Type' => 'application/json',
   'X-API-KEY' => 'API_KEY'
  ),
  'body' => json_encode(array(
   'seed' => $seed,
   'dataset' => $dataset
  ))
 ));

 return json_decode(wp_remote_retrieve_body($response), true);

}

Esempio utilizzo

$seed = array(
 "offer" => "bicicletta",
 "request" => "chitarra"
);

$dataset = array(
 array("offer"=>"chitarra","request"=>"libro"),
 array("offer"=>"libro","request"=>"bicicletta")
);

$result = biagio_match($seed, $dataset);

print_r($result);

Note

Richiedi accesso