Salt la conținut
Limbă:Română
Începeți

Dezvoltatori

Produse personalizate cu laserul, printr-un API REST

Conectați propriul magazin, un marketplace sau un sistem intern la atelierul nostru. Creați design-uri, obțineți oferte exacte, plasați comenzi și urmăriți-le prin webhook-uri.

Cereți acces anticipat

API-ul se deschide după lansarea pe Shopify. Cereți acces anticipat și spuneți-ne ce construiți.

Ce puteți face

Tot ce vă trebuie pentru a vinde produse personalizate

  • Citiți catalogul

    Modele, materiale, dimensiuni, fonturi și prețuri în moneda dumneavoastră, cu toate textele în cinci limbi.

  • Creați design-uri

    Încărcați fotografiile clienților, trimiteți valorile câmpurilor și primiți un design cu imagine de previzualizare. Verificăm noi rezoluția fotografiilor.

  • Obțineți oferte exacte

    Produse, livrare și TVA pentru orice destinație, calculate de același cod care taxează comanda.

  • Plasați și urmăriți comenzi

    O singură cerere per comandă, plătită din soldul preplătit. Urmăriți starea și anulați comanda cât timp încă se poate.

  • Webhook-uri la fiecare pas

    Creată, în așteptare, în producție, expediată, livrată, plus alerte de sold scăzut. Fiecare webhook este semnat cu HMAC-SHA256.

  • Verificați soldul

    Soldul și întregul istoric al tranzacțiilor, ca evidența dumneavoastră să corespundă mereu cu a noastră.

Exemplu

O singură cerere plasează o comandă

Comanda este plătită din sold. Răspunsul conține numărul nostru de comandă și starea ei, iar de acolo urmează webhook-urile.

Cerere
curl https://api.staging.gravilo.eu/v1/orders \
  -H "Authorization: Bearer gvl_live_…" \
  -H "Idempotency-Key: 7d0f9a52-order-1042" \
  -H "Content-Type: application/json" \
  -d '{
    "external_id": "1042",
    "customer_locale": "de",
    "ship_to": {
      "name": "Lena Schmidt",
      "line1": "Lindenstraße 12",
      "postal_code": "10969",
      "city": "Berlin",
      "country": "DE"
    },
    "items": [
      { "design_id": "0192a5c4-7b1e-7c3d-9f00-5d1e2a3b4c5d", "quantity": 2 }
    ]
  }'
Răspuns
HTTP/1.1 201 Created

{
  "id": "0192a5c4-8f02-7a11-b3c0-1e9d4c7a2b60",
  "number": "GV-001042",
  "external_id": "1042",
  "is_test": false,
  "status": "received",
  "hold_reason": null,
  "billing_status": "charged",
  "placed_at": "2026-10-08T09:41:00Z"
}

Gândit pentru integrare

Previzibil, testabil, documentat

  • Mod de test

    Cheile de test validează și calculează prețul comenzilor fără să taxeze sau să producă ceva.

  • Reîncercări sigure

    Trimiteți un Idempotency-Key la fiecare POST. Aceeași cerere nu creează niciodată două comenzi.

  • OpenAPI 3.1

    O specificație citibilă de mașini și o documentație de referință, generate din schemele cu care API-ul validează datele.

  • Erori clare

    Detalii de eroare (RFC 9457) cu coduri stabile și câmpul exact care trebuie corectat.

Sunteți gata să începeți?

Începeți cu aplicația Shopify sau conectați propriul sistem prin API.

Cereți acces anticipatAplicația Shopify