Uusi GET-rajapinta kontaktien hakuun API-tokenilla

Olemme julkaisseet uuden rajapinnan, jonka avulla voit hakea kontaktitietoja automaattisesti, turvallisesti ja hallitusti suoraan Groweosta API-tokenin avulla.

Rajapinta on suunniteltu tilanteisiin, joissa haluat lukea ja hyödyntää Groweossa olevia kontaktitietoja esimerkiksi integraatioissa, raportoinnissa tai ulkoisissa järjestelmissä, ilman manuaalista tiedonsiirtoa.

Rajapinnan käyttö ja API-token sisältyvät Groweo®-lisenssisi hintaan.

Mitä rajapinnan avulla voi tehdä?

Uuden GET-rajapinnan avulla voidaan hakea kontaktitietoja Groweosta API-tokenin perusteella. 

Tämä mahdollistaa esimerkiksi kontaktidatan hyödyntämisen omissa järjestelmissä, asiakastietojen synkronoinnin luettavaksi toiseen palveluun tai raportointitarpeiden tukemisen.

API-tokenit määritetään (ja tarvittaessa poistetaan käytöstä) Groweon asiakasvastaavasi toimesta. Näin varmistamme, että käyttöoikeuksien hallinta pysyy selkeänä ja kontrolloituna.

Mitä rajapinnan avulla ei voi tehdä?

Rajapinta on tarkoitettu vain kontaktien hakemiseen. Sen kautta ei voi lisätä, muokata tai poistaa kontakteja Groweossa.

Groweo ei myöskään lähetä tai vastaanota kontaktidataa POST-metodilla. Tämä tarkoittaa sitä, että rajapinta ei työnnä tietoa ulkoisiin järjestelmiin eikä sen kautta voi lähettää uutta dataa Groweoon.

Kenelle tämä sopii?

Ratkaisu sopii yrityksille, jotka tarvitsevat hallitun ja turvallisen tavan hakea ja lukea kontaktitietoja Groweosta omiin käyttötarpeisiinsa.

Se on erityisen hyödyllinen tilanteissa, joissa kontaktidataa halutaan käyttää osana integraatioita, analytiikkaa tai sisäisiä prosesseja ilman manuaalista vientiä. Rajapinnan käyttö sisältyy olemassaolevaan Groweo®-lisenssiisi.

Miten saan GET-rajapinnan käyttööni?

Voit pyytää API-tokenin omalta asiakasvastaavaltasi tai Groweon asiakaspalvelusta. 

Alta löydät API-esimerkit, joilla voit testata rajapinnan kautta haettavia tietoja yhdessä teknisen toteuttajasi kanssa.

curl --location 'https://engine.groweo.com/engine/api/client-api/contacts?page=1&limit=50' \
--header 'x-client-api-token: <YOUR_API_TOKEN_HERE>'

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://engine.groweo.com/engine/api/client-api/contacts?page=1&limit=50',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_HTTPHEADER => array(
    'x-client-api-token: <YOUR_API_TOKEN_HERE>'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;
?>

import http.client

conn = http.client.HTTPSConnection("engine.groweo.com")
payload = ''
headers = {
  'x-client-api-token': '<YOUR_API_TOKEN_HERE>'
}
conn.request("GET", "/engine/api/client-api/contacts?page=1&limit=50", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

const myHeaders = new Headers();
myHeaders.append("x-client-api-token", "<YOUR_API_TOKEN_HERE>");

const requestOptions = {
  method: "GET",
  headers: myHeaders,
  redirect: "follow"
};

fetch("https://engine.groweo.com/engine/api/client-api/contacts?page=1&limit=50", requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));