Sări la conținutul principal

Colecția Postman

Importați colecția Postman Qarta pentru a testa rapid toate cele 36 de puncte finale API.

Descărcați colecția​

Colecția este disponibilă ca fișier JSON exportat pe care îl puteți importa direct în Postman.

Descărcați colecția Qarta (JSON)

Cum să importați​

Pasul 1: Descărcați colecția​

Faceți clic pe linkul de descărcare de mai sus pentru a salva fișierul qarta.json pe computerul dvs.

Pasul 2: Importați în Postman​

Opțiune A: Importare fișier

  1. Deschideți Postman
  2. Faceți clic pe File → Import (sau butonul Import din colțul stânga sus)
  3. Selectați fila Upload Files
  4. Alegeți fișierul qarta.json pe care l-ați descărcat
  5. Faceți clic pe Import

Opțiune B: Importare folder

  1. Deschideți Postman
  2. Faceți clic pe File → Import
  3. Trageți și plasați fișierul qarta.json în dialogul de import
  4. Faceți clic pe Import

Configurați cheia API​

Odată importată, va trebui să configurați cheia API:

Metoda 1: Folosind variabile de mediu (recomandat)​

  1. În Postman, faceți clic pe Environments (stânga jos)

  2. Faceți clic pe Create New Environment

  3. Denumiți-o: Qarta

  4. Adăugați aceste variabile:

    • Key: api_key | Value: YOUR_QARTA_API_KEY_HERE
    • Key: base_url | Value: https://graph.quarticle.ro

  5. Faceți clic pe Save

  6. În colțul dreapta sus, selectați mediul dvs Qarta din meniu derulant

Acum toate cererile vor utiliza automat cheia API prin {{api_key}} și URL de bază prin {{base_url}}.

Metoda 2: Configurare manuală de antet​

Dacă nu utilizați variabile de mediu:

  1. În fiecare cerere, accesați fila Headers
  2. Găsiți antetul Authorization
  3. Schimbați valoarea din YOUR_API_KEY în YOUR_ACTUAL_API_KEY

Testați o cerere​

  1. Selectați orice punct final din colecție (de ex., GET /graph/api/v1/places/geocode)
  2. Faceți clic pe Send
  3. Ar trebui să vedeți răspunsul API

Dacă obțineți o eroare 401 Unauthorized:

  • Verificați că cheia API este corectă
  • Verificați că ați selectat mediul corect (dacă utilizați variabile)
  • Asigurați-vă că antetul Authorization este setat corect

Conținutul colecției​

Această colecție include toate cele 36 de puncte finale pentru Qarta, organizate după zonă funcțională:

Servicii de locație (3 puncte finale)​

  • Address Autocomplete - GET /graph/api/v1/places/autocomplete
  • Geocode Address - GET /graph/api/v1/places/geocode
  • Reverse Geocode - GET /graph/api/v1/places/geocode/reverse

Analiza portofoliului V1 (12 puncte finale)​

  • Get Provision - GET /graph/api/v1/reports/portfolio/provision
  • Get Points - POST /graph/api/v1/reports/portfolio/points/selection
  • Get Entries - POST /graph/api/v1/reports/portfolio/entries/selection
  • Accumulate Data - POST /graph/api/v1/reports/portfolio/accumulation/selection

Analiza portofoliului V2 (10 puncte finale)​

  • V2 Get Points - POST /graph/api/v2/reports/portfolio/points/selection
  • V2 Get Entries - POST /graph/api/v2/reports/portfolio/entries/selection
  • V2 Accumulate Data - POST /graph/api/v2/reports/portfolio/accumulation/selection

Îmbogățire de puncte (2 puncte finale)​

  • Enrich Single Point - GET /graph/featureinfo/risk-lookup/api/v1/bfi/single
  • Batch Enrich Points - POST /graph/featureinfo/enrichment/api/v1/bfi/batch

Servicii web (6 puncte finale)​

  • WMS Get Capabilities - GET /graph/layers/wms/GetCapabilities
  • WMS Get Map - GET /graph/layers/wms/GetMap
  • WFS Get Feature - GET /graph/layers/wfs/GetFeature

Evenimente live (1 punct final)​

  • Enrich Live Event Entries - POST /graph/api/v1/live-events/footprints/:footprint/enrich/entries

Sfaturi și trucuri​

Utilizare script pre-cerere​

Pentru a seta antetele sau tokenurile automat înainte de fiecare cerere:

  1. Deschideți o cerere
  2. Accesați fila Pre-request Script
  3. Adăugați cod JavaScript de rulat înainte de cerere

Exemplu: Setați cheia API din variabila de mediu

pm.request.headers.add({
  key: 'Authorization',
  value: `${pm.environment.get('api_key')}`
});

Utilizare teste​

Pentru a valida răspunsurile:

  1. Deschideți o cerere
  2. Accesați fila Tests
  3. Adăugați cod JavaScript de rulat după cerere

Exemplu: Verificați codul de stare este 200

pm.test('Status code is 200', function() {
  pm.response.to.have.status(200);
});

Depanare​

Colecția nu se importează​

  • Asigurați-vă că fișierul JSON nu este corupt
  • Încercați să descărcați din nou colecția
  • Verificați că Postman este actualizat

Cererile eșuează cu 401​

  • Verificați că cheia API este validă
  • Verificați că nu a expirat în panoul Quarticle
  • Asigurați-vă că antetul Authorization include cheia API

Cererile eșuează cu 404​

  • Verificați că URL-ul de bază este corect (https://graph.quarticle.ro)
  • Verificați că calea punctului final se potrivește cu colecția
  • Verificați parametrul source (numele portofoliu) dacă utilizați puncte finale de portofoliu

Aflați mai mult​

Pașii următori​