Chei API
Creează cheia care conectează site-ul sau software-ul tău la Measure Map Online, alege ce are voie să facă, ține separat munca reală de cea de test și înlocuiește sau restricționează cheia în siguranță.
O cheie API permite site-ului sau software-ului tău să lucreze cu contul tău Measure Map Online: să afișeze harta unui proiect pe site, să pornească proiecte pentru vizitatorii tăi sau să citească și să modifice proiecte prin API-ul REST. Creezi și gestionezi cheile pe pagina Dezvoltator.
Deschide pagina Dezvoltator#
În meniul tabloului de bord, la Avansat, apasă Dezvoltator. Se deschide pe Chei API, iar celelalte secțiuni ale ei sunt listate sub ea în meniu (pe telefon, ca file în partea de sus a paginii):
- Link de invitat (Open Guest): linkul fără cod pentru site-ul tău. Vezi Open Guest.
- Încearcă API-ul, Webhook-uri și REST API: vezi referința API.
- Încorporează o hartă (Enterprise): vezi API-ul iFrame.
- Proiecte private (Enterprise): afișează proiectele private ale clienților în hărțile tale încorporate. Vezi proiectele private ale clienților.
Insigna din partea de sus a cardului cheii arată dacă cheia ta este Activ, Neactivat (încă nu ai o cheie), Dezactivat (accesul la API este suspendat: nicio cheie nu funcționează și nu se poate crea una nouă până când asistența ridică suspendarea) sau Expirat (abonamentul nu este activ).
Live și Sandbox#
În partea de sus a cardului cheii, comută între Live și Sandbox. Fiecare are cheia ei, iar pagina o afișează pe cea aleasă. Alegerea se aplică și în Încearcă API-ul și rămâne cât timp treci de la o secțiune la alta. Încorporează o hartă și Link de invitat folosesc întotdeauna cheia ta live, pentru că vizitatorii site-ului tău pot deschide doar proiecte live: deschiderea oricăreia dintre ele readuce pagina pe Live.
- Live este contul tău real, iar pagina se deschide pe el. Folosește o cheie live pe site-ul tău.
- Sandbox este pentru construirea și testarea unei integrări. Proiectele, dosarele și produsele create cu o cheie sandbox sunt ținute separat de cele reale: o cheie live nu le poate vedea, iar o cheie sandbox nu poate vedea proiectele tale live. Cererile făcute cu o cheie sandbox nu sunt numărate în cifrele de utilizare, iar proiectele de invitat create cu una nu se facturează niciodată.
Crearea unei chei sandbox noi nu afectează niciodată cheia ta live, și invers.
Alege ce poate face cheia#
Când creezi o cheie, dialogul listează fiecare zonă a API-ului la Acces pentru cheia nouă. Alege cât de departe ajunge noua cheie în fiecare:
| Zonă | Opțiuni | Ce permite |
|---|---|---|
| Hărți încorporate (Enterprise) | Fără acces, Permis | Conectează un spectator la o hartă încorporată. Majoritatea integrărilor au nevoie doar de aceasta. |
| Proiecte pentru invitați (Open Guest) | Fără acces, Permis | Începe un proiect de invitat pentru un vizitator, cu un token de pe serverul tău. Majoritatea integrărilor au nevoie doar de aceasta. |
| Proiecte | Fără acces, Citire, Citire și modificare | Proiecte și foldere, cu măsurătorile, comentariile și exporturile lor. |
| Utilizatori (Enterprise) | Fără acces, Citire, Citire și modificare | Utilizatorii organizației tale, invitațiile, licențele și echipele lor. |
| Organizație (Enterprise) | Fără acces, Citire, Citire și modificare | Profilul, politica, autentificarea unică și jurnalul de activitate al organizației tale, și licențele ei. |
| Produse | Fără acces, Citire, Citire și modificare | Catalogul tău de produse și prețurile lui. |
| Invitați (Open Guest) | Fără acces, Citire, Citire și modificare | Linkul tău de invitat, proiectele invitaților și cererile de ofertă, cu datele de contact ale invitaților tăi, și bugetul tău. |
| Cont | Fără acces, Citire, Citire și modificare | Planul, licențele, utilizarea API, profilul și setările de e-mail, iar pe Open Guest cheltuielile și bugetul. |
| Dezvoltator | Fără acces, Citire, Citire și modificare | Cheile tale API și webhookul. O cheie nu trece niciodată de propriul acces. |
| Clienți (partener) | Fără acces, Citire, Citire și modificare | Clienții tăi, planurile pe care le plătești pentru ei, invitațiile și facturile lor. |
Dialogul arată doar zonele incluse în planul tău. Ține cursorul peste o opțiune ca să vezi exact ce acordă. Prima ta cheie începe doar cu Hărți încorporate, cât are nevoie o hartă încorporată; o cheie care o înlocuiește pe alta începe cu accesul acelei chei. Alege cel puțin o zonă.
Ce poate face o cheie se stabilește la crearea ei. Ca să dai unei chei mai mult sau mai puțin acces, creează una nouă.
Creează o cheie#
- Alege Live sau Sandbox în partea de sus a cardului cheii.
- Apasă Generează o cheie nouă. Se deschide un dialog, cu Live sau Sandbox lângă titlu.
- Stabilește accesul la Acces pentru cheia nouă (vezi mai sus).
- Dacă vrei, scrie un nume în Nume pentru cheia nouă (opțional), ca să-ți deosebești cheile.
- Apasă Creează.
Dialogul spune apoi Cheia ta nouă este gata. O poți copia din nou de pe această pagină oricând. Arată cheia, ascunsă în afară de primele și ultimele caractere, și ce Poate face. Apasă ca s-o afișezi complet sau ca s-o copiezi în întregime, apoi apasă Gata. Cardul cheii o afișează la fel la Cheia ta API. Primești un e-mail de fiecare dată când se creează o cheie în contul tău.
Chei create înainte de setările de acces#
O cheie creată înainte ca cheile să aibă setări de acces poate face totul, cu excepția lucrului cu produsele. Astfel de chei sunt scoase din uz: cardul cheii spune când nu va mai funcționa a ta și primești și o notificare. Apasă Generează o cheie nouă, pe care cardul îl afișează atunci ca buton principal, și înlocuiește cheia veche pe site-ul sau pe serverul tău înainte de acea dată. Dialogul pornește doar cu Hărți încorporate, așa că alege mai mult dacă serverul tău are nevoie.
Înlocuiește o cheie#
Apasă din nou Generează o cheie nouă când ai o cheie și creează-o pe cea nouă în dialog. Dialogul spune ce se întâmplă cu cheia actuală: Se va crea o cheie nouă, iar cheia ta actuală va continua să funcționeze 24 de ore, ca să poți actualiza site-urile care o folosesc. O poți revoca mai devreme când ai terminat. O cheie creată înainte de setările de acces continuă să funcționeze până la data care ți-a fost comunicată.
Cheia veche trece la Chei anterioare, cu timpul care îi mai rămâne, momentul ultimei utilizări și ce poate face. Încă sunt acceptate cât timp introduci noua cheie. Revocă una imediat ce nu o mai folosește nimic. Ca s-o oprești imediat, apasă Revocă și confirmă; orice site care încă o folosește încetează să funcționeze pe loc. Primești un e-mail când o cheie este revocată.
Restricțiile pentru site-uri sunt copiate pe cheia nouă. Poți crea o cheie nouă cam o dată pe minut.
Restricționează cheia la site-urile tale#
Numai site-urile din această listă pot folosi cheia ta într-un browser: hărțile încorporate și cererile din pagini de pe orice alt site sunt refuzate. Apelurile de pe un server nu sunt afectate.
- La Restricții de site, scrie site-ul tău în
Introdu un site sau un domeniu: un domeniu precum
example.com, o adresă IP saulocalhost. Poți lipi o adresă completă: se păstrează doar numele site-ului, fărăhttps://, calea sau portul. - Apasă Adaugă.
Un domeniu acoperă și subdomeniile sale: example.com permite
shop.example.com. Apasă ca să elimini un site și
confirmă; după ultimul, cheia funcționează de pe orice site. Primești un e-mail
ori de câte ori un site este eliminat de pe o cheie.
Lista se aplică browserelor. O hartă încorporată se deschide doar pe o pagină a unui site din listă; când browserul nu spune pe ce pagină se află, este refuzată. O cerere API REST trimisă dintr-o pagină web trebuie să vină de la un site din listă. O cerere de la propriul tău server nu indică niciun site și nu este verificată. Measure Map Online însuși este întotdeauna permis, așa că previzualizările de pe această pagină continuă să funcționeze.
Vezi cum este folosită cheia#
Utilizare însumează toate cheile tale live, așa că cifrele continuă când înlocuiești o cheie. Arată cererile din ultimele 30 de zile, atât de la hărțile încorporate, cât și de la API-ul REST, cu o bară pentru fiecare zi; totalul Tot timpul; Ultimul acces; momentul în care a fost creată cheia actuală (Cheie creată); și Domenii de top: site-urile care îți folosesc cel mai mult cheile. Un site pe care nu-l recunoști aici este un motiv să restricționezi sau să înlocuiești cheia.
Cererile sandbox nu sunt numărate, așa că cifrele apar doar pe Live. Nici cererile pe care le face această pagină singură, în Încearcă API-ul și în previzualizări, nu sunt numărate.
Păstrează-ți cheia în siguranță#
- Dă fiecărei chei doar accesul de care are nevoie. O cheie dintr-o pagină web (de exemplu în adresa unei hărți încorporate) ar trebui să aibă doar Hărți încorporate.
- Această cheie poate modifica datele tale. Păstrează-l pe serverul tău, niciodată într-o pagină web sau o aplicație.
- Restricționează la propriile site-uri o cheie folosită în pagini web.
- Lasă cheia ascunsă pe pagină când îți partajezi ecranul; pentru a o copia nu e nevoie s-o afișezi.
- Dacă o cheie ar fi putut ajunge pe mâini greșite, creează una nouă și revocă imediat pe cea veche de la Chei anterioare.
- Construiește și testează cu o cheie Sandbox, ca experimentele să nu ajungă niciodată printre proiectele tale reale.
Mai ai nevoie de ajutor?
Scrie echipei noastre de suport și spune-ne ce încercai să faci. Capturile de ecran ajută.