fullmetrixDocs

API-sleutels

Maak een sleutel aan zodat een andere tool je Fullmetrix-rapporten kan lezen, bewaar hem veilig en trek hem in wanneer je hem niet meer nodig hebt.

Een API-sleutel is een wachtwoord voor software. Hiermee kan een externe tool je Fullmetrix-rapporten lezen zonder je persoonlijke account te gebruiken. Je hebt er een nodig voor drie toepassingen.

  • De Looker Studio-connector, om je eigen Google-dashboards te bouwen.
  • De openbare API, zodat een ontwikkelaar je cijfers kan ophalen in andere software, een spreadsheet of een BI-tool.
  • De MCP-server, om je gegevens te bevragen vanuit een compatibele AI-assistent.

Een sleutel geeft leestoegang tot de rapporten van de hele organisatie, alle winkels inbegrepen. Hij kan je instellingen of je gegevens niet wijzigen.

Om je sleutels te beheren, klik je in de zijbalk op Instellingen en daarna op het tabblad API-sleutels.

Tabblad API-sleutels in Instellingen met de tabel van sleutels, de kolommen Naam, Voorvoegsel, Gemaakt en Laatst gebruikt, en rechtsboven de knop Maak een sleutel gemarkeerd

Een sleutel aanmaken

Het aanmaken van een sleutel openen

Klik rechtsboven in de kaart API-sleutels op Maak een sleutel. Het venster Maak een API-sleutel opent.

De sleutel een naam geven

Typ bij Sleutelnaam de naam van de tool die hem gaat gebruiken, bijvoorbeeld "Looker Studio" of "Spreadsheet voor het beheer". Aan deze naam zie je later welke sleutel je moet intrekken. Klik daarna op Maak een sleutel of druk op Enter.

De sleutel kopiëren

De volledige sleutel verschijnt, met de melding Kopieer deze sleutel nu. Na het sluiten van dit venster wordt het niet meer weergegeven. Klik op het kopieerpictogram rechts van de sleutel. De melding Sleutel gekopieerd naar klembord bevestigt het. Plak hem meteen in de tool of in je wachtwoordbeheerder.

Het venster sluiten

Klik op Klaar. De sleutel verschijnt in de tabel.

Venster Maak een API-sleutel met een sleutel die met fmx_ begint, de waarschuwing om te kopiëren en de kopieerknop gemarkeerd

De sleutel wordt maar één keer getoond

We bewaren de sleutel niet in leesbare vorm, dus we kunnen hem je niet opnieuw tonen. Heb je hem kwijtgeraakt, maak dan een nieuwe aan en trek de oude in.

Elke sleutel begint met fmx_. Mislukt het aanmaken, dan verschijnt de melding Sleutel aanmaken mislukt. Probeer het wat later opnieuw.

De tabel met sleutels lezen

KolomWat ze toont
NaamDe naam die je de sleutel hebt gegeven
VoorvoegselDe eerste tekens van de sleutel, om hem in een tool te herkennen zonder hem volledig te tonen
GemaaktDe aanmaakdatum
Laatst gebruiktDe datum van de laatste aanroep met deze sleutel, of een streepje als hij nooit is gebruikt

Zolang er geen sleutel bestaat, toont de kaart Er zijn nog geen API-sleutels aangemaakt.

De kolom Laatst gebruikt helpt je opruimen. Een sleutel die al maanden niet is gebruikt, hoort vaak bij een verlaten tool. Trek hem in.

Een sleutel intrekken

Het intrekken van een sleutel schakelt hem definitief uit. Doe het wanneer een tool niet meer wordt gebruikt, wanneer een freelancer je project verlaat of als je denkt dat iemand anders de sleutel heeft gezien.

Op Herroepen klikken

Klik in de rij van de sleutel op Herroepen.

Bevestigen

Het venster API-sleutel intrekken herinnert je eraan dat integraties die deze sleutel gebruiken niet meer werken. Klik op Herroepen om te bevestigen of op Annuleren.

De melding API-sleutel ingetrokken bevestigt het. De rij blijft als register in de tabel staan, met het label Ingetrokken. Het intrekken is direct en kan niet ongedaan worden gemaakt. Om de tool opnieuw te koppelen, maak je een nieuwe sleutel aan.

Je sleutels veilig bewaren

Met een sleutel kan iemand al je verkoopcijfers lezen. Behandel hem als een wachtwoord.

  • Maak één sleutel per tool aan, zodat je er één kunt afsnijden zonder de andere aan te raken.
  • Stuur hem nooit in leesbare tekst per e-mail of chat en plak hem nooit op een openbare pagina of in code die je bezoekers kunnen zien.
  • Trek hem in zodra hij niet meer nodig is.

We vragen je nooit per e-mail of telefoon om een API-sleutel.

Veelgestelde vragen

Op deze pagina