Aller au contenu
Langue:Français
Commencer

Développeurs

Des produits personnalisés au laser, via une API REST

Connectez votre propre boutique, une marketplace ou un système interne à notre atelier. Créez des designs, obtenez des devis exacts, passez des commandes et suivez-les par webhooks.

Demander un accès anticipé

L’API ouvrira après notre lancement sur Shopify. Demandez un accès anticipé et dites-nous ce que vous construisez.

Ce que vous pouvez faire

Tout ce qu’il faut pour vendre des produits personnalisés

  • Lire le catalogue

    Modèles, matériaux, tailles, polices et prix dans votre devise, avec tous les textes en cinq langues.

  • Créer des designs

    Importez les photos de vos clients, envoyez les valeurs des champs et recevez un design avec son image d’aperçu. Nous vérifions la résolution des photos pour vous.

  • Obtenir des devis exacts

    Articles, livraison et TVA pour n’importe quelle destination, calculés par le même code que celui qui facture la commande.

  • Passer et suivre des commandes

    Une requête par commande, payée depuis votre solde prépayé. Suivez son statut et annulez-la tant que c’est encore possible.

  • Des webhooks à chaque étape

    Créée, en attente, en production, expédiée, livrée, plus des alertes de solde bas. Chaque webhook est signé en HMAC-SHA256.

  • Consulter votre solde

    Votre solde et tout son historique, pour que vos comptes correspondent toujours aux nôtres.

Exemple

Une requête suffit pour passer une commande

La commande est payée depuis votre solde. La réponse indique notre numéro de commande et son statut, puis les webhooks prennent le relais.

Requête
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éponse
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"
}

Pensée pour l’intégration

Prévisible, testable, documentée

  • Mode test

    Les clés de test valident et chiffrent les commandes sans rien facturer ni fabriquer.

  • Relances sans risque

    Envoyez un Idempotency-Key avec chaque POST. Une même requête ne crée jamais deux commandes.

  • OpenAPI 3.1

    Une spécification lisible par les machines et une documentation de référence, générées à partir des schémas qui valident l’API.

  • Des erreurs claires

    Des détails de problème (RFC 9457) avec des codes stables et le champ exact à corriger.

Prêt à commencer ?

Commencez avec l’application Shopify, ou connectez votre propre système via l’API.

Demander un accès anticipéApplication Shopify