API-nøgler
Opret den nøgle, der forbinder dit websted eller din software med Measure Map Online, vælg hvad den må, hold live- og testarbejde adskilt, og udskift eller begræns den sikkert.
En API-nøgle lader dit eget websted eller din egen software arbejde med din Measure Map Online-konto: vise et projekts kort på dit websted, starte projekter til dine besøgende eller læse og ændre projekter via REST API'et. Du opretter og administrerer nøgler på siden Udvikler.
Åbn siden Udvikler#
Tryk på Udvikler under Avanceret i dashboardmenuen. Den åbner på API-nøgler, og de øvrige afsnit står under den i menuen (på en telefon som faner øverst på siden):
- Gæstelink (Open Guest): linket uden kode til dit websted. Se Open Guest.
- Prøv API'en, Webhooks og REST API: se API-referencen.
- Indlej et kort (Enterprise): se iFrame API.
- Private projekter (Enterprise): vis kunders private projekter i dine indlejrede kort. Se kunders private projekter.
Mærket øverst på nøglekortet fortæller, om din nøgle er Aktiv, Ikke aktiveret (endnu ingen nøgle), Deaktiveret (API-adgangen er suspenderet: ingen nøgle virker, og der kan ikke oprettes en ny, før supporten ophæver det) eller Udløbet (abonnementet er ikke aktivt).
Live og Sandbox#
Øverst på nøglekortet skifter du mellem Live og Sandbox. Hver har sin egen nøgle, og siden viser den, du vælger. Valget gælder også i Prøv API'en, og det bevares, mens du skifter mellem afsnit. Indlej et kort og Gæstelink bruger altid din livenøgle, fordi besøgende på dit websted kun kan åbne liveprojekter: når du åbner et af dem, skifter siden tilbage til Live.
- Live er din rigtige konto, og siden åbner på den. Brug en livenøgle på dit websted.
- Sandbox bruges til at bygge og teste en integration. Projekter, mapper og produkter oprettet med en sandboxnøgle holdes adskilt fra dine rigtige: en livenøgle kan ikke se dem, og en sandboxnøgle kan ikke se dine live. Forespørgsler med en sandboxnøgle tæller ikke med i dine forbrugstal, og gæsteprojekter oprettet med en faktureres aldrig.
Når du opretter en ny sandboxnøgle, påvirker det aldrig din livenøgle, og omvendt.
Vælg, hvad nøglen må#
Når du opretter en nøgle, viser dialogen hvert område af API'et under Adgang for den nye nøgle. Vælg, hvor langt den nye nøgle rækker ind i hvert af dem:
| Område | Valg | Hvad det tillader |
|---|---|---|
| Indlejrede kort (Enterprise) | Ingen adgang, Tilladt | Log en seer ind på et indlejret kort. De fleste integrationer har kun brug for dette. |
| Gæsteprojekter (Open Guest) | Ingen adgang, Tilladt | Start et gæsteprojekt for en besøgende med et token fra din server. De fleste integrationer har kun brug for dette. |
| Projekter | Ingen adgang, Læs, Læs og ændr | Projekter og mapper, med deres målinger, kommentarer og eksporter. |
| Brugere (Enterprise) | Ingen adgang, Læs, Læs og ændr | Din organisations brugere, deres invitationer, licenser og teams. |
| Organisation (Enterprise) | Ingen adgang, Læs, Læs og ændr | Din organisations profil, politik, single sign-on og aktivitetslog samt dens licenser. |
| Produkter | Ingen adgang, Læs, Læs og ændr | Dit produktkatalog og dets priser. |
| Gæster (Open Guest) | Ingen adgang, Læs, Læs og ændr | Dit gæstelink, gæsteprojekter og tilbudsanmodninger med dine gæsters kontaktoplysninger samt dit budget. |
| Konto | Ingen adgang, Læs, Læs og ændr | Din plan, licenser, API-brug, profil og e-mailindstillinger, og på Open Guest dit forbrug og budget. |
| Udvikler | Ingen adgang, Læs, Læs og ændr | Dine API-nøgler og din webhook. En nøgle rækker aldrig ud over sin egen adgang. |
| Klienter (Partner) | Ingen adgang, Læs, Læs og ændr | Dine klienter, de planer du betaler for dem, deres invitationer og fakturaer. |
Dialogen viser kun de områder, dit abonnement omfatter. Hold markøren over et valg for at se præcis, hvad det giver. Din første nøgle starter kun med Indlejrede kort, som er alt, et indlejret kort har brug for; en nøgle, der erstatter en anden, starter med den nøgles adgang. Vælg mindst ét område.
Hvad en nøgle må, fastlægges, når du opretter den. For at give en nøgle mere eller mindre adgang skal du oprette en ny.
Opret en nøgle#
- Vælg Live eller Sandbox øverst på nøglekortet.
- Tryk på Generér ny nøgle. En dialog åbnes med Live eller Sandbox ved siden af titlen.
- Indstil adgangen under Adgang for den nye nøgle (se ovenfor).
- Hvis du vil, kan du skrive et navn i Navn til den nye nøgle (valgfrit), så du kan kende dine nøgler fra hinanden.
- Tryk på Opret.
Dialogen siger derefter Din nye nøgle er klar. Du kan kopiere den igen fra denne side når som helst. Den viser nøglen, skjult på nær de første og sidste tegn, og hvad den Kan gøre. Tryk på for at vise den helt, eller på for at kopiere hele nøglen, og tryk derefter på Færdig. Nøglekortet viser den på samme måde under Din API-nøgle. Du får en e-mail, hver gang der oprettes en nøgle på din konto.
Nøgler oprettet før adgangsindstillinger#
En nøgle oprettet, før nøgler havde adgangsindstillinger, kan alt undtagen at arbejde med produkter. Sådanne nøgler udfases: nøglekortet fortæller, hvornår din holder op med at virke, og du får også en notifikation. Tryk på Generér ny nøgle, som kortet så viser som hovedknap, og udskift den gamle nøgle på dit websted eller din server inden den dato. Dialogen starter kun med Indlejrede kort, så vælg mere, hvis din server har brug for det.
Udskift en nøgle#
Tryk på Generér ny nøgle igen, når du har en nøgle, og opret den nye i dialogen. Dialogen fortæller, hvad der sker med den nuværende nøgle: Der oprettes en ny nøgle, og din nuværende nøgle bliver ved med at virke i 24 timer, så du kan opdatere de websteder, der bruger den. Du kan tilbagekalde den før, når du er færdig. En nøgle oprettet før adgangsindstillinger bliver ved med at virke indtil den dato, du fik oplyst.
Den gamle nøgle flyttes til Tidligere nøgler med den tid, den har tilbage, hvornår den sidst blev brugt, og hvad den kan. Accepteres stadig, mens du ruller den nye nøgle ud. Tilbagekald en, så snart intet bruger den. For at stoppe den med det samme skal du trykke på Tilbagekald og bekræfte; alle websteder, der stadig bruger den, holder op med at virke øjeblikkeligt. Du får en e-mail, når en nøgle tilbagekaldes.
Dine begrænsninger for websteder kopieres til den nye nøgle. Du kan oprette en ny nøgle cirka en gang i minuttet.
Begræns nøglen til dine websteder#
Kun webstederne på denne liste kan bruge din nøgle i en browser: indlejrede kort og anmodninger fra sider på andre websteder afvises. Kald fra en server påvirkes ikke.
- Under Webstedsbegrænsninger skriver du dit websted i
Indtast et websted eller domæne: et domæne som
example.com, en IP-adresse ellerlocalhost. Du kan indsætte en fuld adresse: kun webstedets navn beholdes, udenhttps://, stien eller porten. - Tryk på Tilføj.
Et domæne dækker også sine underdomæner: example.com tillader
shop.example.com. Tryk på for at fjerne et websted, og
bekræft; efter det sidste virker nøglen fra et hvilket som helst websted. Du
får en e-mail, hver gang et websted fjernes fra en nøgle.
Listen gælder for browsere. Et indlejret kort åbner kun på en side på et websted fra listen; når browseren ikke oplyser, hvilken side den er på, afvises det. En REST API-forespørgsel sendt fra en webside skal komme fra et websted fra listen. En forespørgsel fra din egen server nævner intet websted og kontrolleres ikke. Measure Map Online selv er altid tilladt, så forhåndsvisningerne på denne side bliver ved med at virke.
Se, hvordan nøglen bruges#
Forbrug lægger alle dine livenøgler sammen, så tallene fortsætter, når du udskifter en nøgle. Det viser forespørgslerne de seneste 30 dage, både fra indlejrede kort og fra REST API'et, med en søjle for hver dag; totalen Altid; Seneste adgang; hvornår den nuværende nøgle blev oprettet (Nøgle oprettet); og Topdomæner: de websteder, der bruger dine nøgler mest. Et websted, du ikke kender, er en grund til at begrænse eller udskifte nøglen.
Sandboxforespørgsler tælles ikke med, så tallene vises kun på Live. Det gør de forespørgsler heller ikke, som denne side selv sender, i Prøv API'en og forhåndsvisningerne.
Hold din nøgle sikker#
- Giv hver nøgle kun den adgang, den har brug for. En nøgle på en webside (for eksempel i et indlejret korts adresse) bør kun have Indlejrede kort.
- Denne nøgle kan ændre dine data. Opbevar den på din server, aldrig på en webside eller i en app.
- Begræns en nøgle, der bruges på websider, til dine egne websteder.
- Lad nøglen være skjult på siden, når du deler din skærm; at kopiere den kræver aldrig, at den vises.
- Hvis en nøgle kan være lækket, så opret en ny og tilbagekald den gamle under Tidligere nøgler med det samme.
- Byg og test med en Sandbox-nøgle, så eksperimenter aldrig havner blandt dine rigtige projekter.
Brug for mere hjælp?
Skriv til vores supportteam og fortæl, hvad du prøvede at gøre. Skærmbilleder hjælper.