Dokumentazioa

Dokumentazio teknikoa eta integrazio gidak

Valqor zure stack-ean integratzeko behar duzun guztia.

Lehen urratsak

Sortu zure lehen marka-esteka, konfiguratu domeinu pertsonalizatua eta esploratu panela.

Erregistratu eta sortu zure lan-eremua
Gehitu domeinu pertsonalizatu bat hemen: Panela → Domeinuak
Sortu zure lehen esteka markadun slug batekin
Ikusi analitika denbora errealean zure panelean

API Erreferentzia

REST API estekak, domeinuak, analitikak eta API giltzak kudeatzeko scope baimenekin.

Autentifikazioa

Sortu API giltza bat hemen: Panela → API Giltzak. Sartu Bearer token gisa:

Authorization: Bearer vq_your_key_here

Integrazioak

Konektatu Valqor zure CRM-ra, CI/CD pipeline-etara, marketing plataformetara eta analitika tresnetara.

Webhookak — Gertaeren jakinarazpenak denbora errealean (HTTPS soilik)
CSV inportazioa eta esportazioa — Esteken kudeaketa masiboa
Bihurketen jarraipena — Pixelean oinarritutako atribuzioa
GA4 — UTM parametroen etiketatze automatikoa

REST API

API endpointak

Oinarrizko URLa: https://valqor.app

POST/api/links

Markadun esteka berri bat sortzen du

Adibidea

curl -X POST https://valqor.app/api/links \
  -H "Authorization: Bearer vq_..." \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "go.example.com",
    "slug": "launch",
    "destination": "https://example.com/product",
    "tags": ["marketing", "launch-2025"]
  }'

GET/api/links

Zure lan-eremuko esteka guztiak zerrendatzen ditu

Adibidea

curl https://valqor.app/api/links \
  -H "Authorization: Bearer vq_..."

PATCH/api/links/:id

Lehendik dagoen esteka bat eguneratzen du

Adibidea

curl -X PATCH https://valqor.app/api/links/lnk_abc123 \
  -H "Authorization: Bearer vq_..." \
  -H "Content-Type: application/json" \
  -d '{ "destination": "https://example.com/new-page" }'

DELETE/api/links/:id

Esteka bat betiko ezabatzen du

Adibidea

curl -X DELETE https://valqor.app/api/links/lnk_abc123 \
  -H "Authorization: Bearer vq_..."

GET/api/analytics

Zure esteken analitika eskuratzen du

Adibidea

curl "https://valqor.app/api/analytics?period=30d" \
  -H "Authorization: Bearer vq_..."

GET/api/domains

Konfiguratutako domeinu pertsonalizatuak zerrendatzen ditu

Adibidea

curl https://valqor.app/api/domains \
  -H "Authorization: Bearer vq_..."

Mugak

Eskaera mugak

APIaren eskaera mugak API giltza bakoitzeko aplikatzen dira, leiho mugikor baten bidez.

Free60 req/min

Pro600 req/min

Business6 000 req/min

Konbentzioak

Erantzunaren formatua

Arrakasta

{
  "item": { "id": "lnk_abc123", "slug": "launch", ... }
}

Errorea

{
  "error": "Slug is already taken",
  "code": "SLUG_COLLISION"
}

Joan panelera