Aller au contenu principal

Intégration de l'API

L'intégration de l'API n'est disponible qu'avec le forfait Premium.

Les requêtes API sont authentifiées à l'aide de votre clé API. Incluez votre clé API dans l'en-tête X-API-Key de chaque requête. Contactez le support pour obtenir la vôtre.

URL de base​

Tous les points de terminaison de l'API sont relatifs à : https://itsgot.com

Pagination​

Pour les points de terminaison qui prennent en charge la pagination, les URL de la page suivante et de la page précédente se trouvent dans l'en-tête HTTP Link.

Récupérer les produits​

GET /api/products​

Paramètres de requête :

  • sku - Le SKU de la variante (facultatif)
  • barcode - Le code-barres de la variante (facultatif)
  • external_product_id - ID du produit Shopify (facultatif)
  • external_variant_id - ID de la variante Shopify (facultatif)
  • page - Page à récupérer (facultatif)
  • per_page - Nombre de produits renvoyés par page, doit être l'une des valeurs 10, 25, 50, 100 (facultatif, 10 par défaut)

Exemple avec curl :

curl -H 'X-API-Key: ***' 'https://itsgot.com/api/products?sku=JARFOOD'

Réponse (200 OK) :

[
  {
    "id": 1,
    "name": "Jar of Food",
    "rating": 0.0,
    "external_product_id": 123123123,
    "variants": [
      {
        "name": "Spicy",
        "size": null,
        "servings_per_container": "1",
        "serving_size": null,
        "ingredients": null,
        "barcode": "834325",
        "external_variant_id": 789789789,
        "warnings": null,
        "instructions": null,
        "claims": null,
        "sku": "JARFOOD",
        "origin_countries": null,
        "allergens": null,
        "created_at": "2026-07-30T13:32:38Z",
        "updated_at": "2026-07-30T13:36:08Z",
        "kosher": false,
        "halal": false,
        "glatt_kosher": true,
        "organic": false,
        "dairy": false,
        "parve": true,
        "vegan": true,
        "vegetarian": true,
        "gmos": null,
        "gluten": null,
        "wheat": null,
        "preservatives": null,
        "artificial_colors": null,
        "artificial_flavors": null,
        "casein": null,
        "egg": null,
        "soy": null,
        "shellfish": null,
        "tree_nuts": null,
        "peanuts": null,
        "fish": null,
        "seeds": null,
        "milk": null,
        "nitrates": null,
        "nitrites": null,
        "sesame": null,
        "coconut": null,
        "rbst": null,
        "rbgh": null,
        "celery": null,
        "translations": {},
        "nutrition": [
          {
            "id": 1,
            "calories": 28,
            "calories_from_fat": null,
            "calories_from_saturated_fat": null,
            "comments": "Per 100g",
            "number": 1,
            "kilojoules": 114,
            "created_at": "2026-08-04T18:48:07Z",
            "updated_at": "2026-08-04T18:48:07Z",
            "data": [
              {
                "id": 1,
                "percent_allowance": null,
                "comments": null,
                "components": null,
                "quantity": {
                  "value": "1",
                  "unit": "mg"
                },
                "type": "nutrient",
                "source": {
                  "id": 10,
                  "name": "Iron",
                  "translations": []
                },
                "created_at": "2026-08-04T18:48:07Z",
                "updated_at": "2026-08-04T18:48:07Z"
              },
              {
                "id": 2,
                "percent_allowance": null,
                "comments": null,
                "components": null,
                "quantity": {
                  "value": "2",
                  "unit": "g"
                },
                "type": "nutrient",
                "source": {
                  "id": 8,
                  "name": "Protein",
                  "translations": []
                },
                "created_at": "2026-08-04T18:48:07Z",
                "updated_at": "2026-08-04T18:48:07Z"
              }
            ]
          }
        ],
        "labels": [
          {
            "id": 10,
            "format": "au_nutrition_facts_vertical",
            "locale": "en-AU",
            "target_device": null
          }
        ]
      }
    ]
  }
]

Exporter une étiquette dans un format donné​

GET /api/products/PRODUCT_ID/labels/LABEL_ID/export.FORMAT​

Paramètres obligatoires :

  • PRODUCT_ID - ID du produit dont vous souhaitez exporter l'étiquette
  • LABEL_ID - ID de l'étiquette que vous souhaitez exporter
  • FORMAT - Format d'exportation. L'un de png, jpg, pdf ou html

Paramètres de requête facultatifs :

  • width - Image uniquement. Exporte l'étiquette à la largeur donnée. La valeur par défaut est la largeur de l'étiquette x 2.
  • height - Image uniquement. Exporte l'étiquette à la hauteur donnée. Par défaut, le rapport hauteur/largeur est conservé et la hauteur est calculée à partir de la largeur donnée.
  • background_color - Image uniquement. Couleur d'arrière-plan à utiliser si l'étiquette est redimensionnée et ne conserve plus son rapport hauteur/largeur

Exemple avec curl :

curl -H 'X-API-Key: ***' 'https://itsgot.com/api/products/123/labels/789/export.jpg' > product.jpg