Obtenir un produit

curl --request GET \
  --url https://qwoty.app/api/products/{id} \
  --header 'Authorization: <authorization>'

const options = {method: 'GET', headers: {Authorization: '<authorization>'}};

fetch('https://qwoty.app/api/products/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://qwoty.app/api/products/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://qwoty.app/api/products/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<authorization>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://qwoty.app/api/products/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "product_parent_id": "660e8400-e29b-41d4-a716-446655440001",
    "workspace_id": "880e8400-e29b-41d4-a716-446655440003",
    "name": "Consulting Services - Senior",
    "api_name": "consulting_services_senior",
    "reference": "SERV-001",
    "description": "Senior consultant hourly rate",
    "description_inherit_from_product": true,
    "primary_image_inherit_from_product": true,
    "is_active": true,
    "is_default": true,
    "catalogs": [
      {
        "id": "770e8400-e29b-41d4-a716-446655440002",
        "name": "Catalogue principal",
        "api_name": "catalog_main"
      }
    ],
    "categories": [],
    "settings": {
      "unit_per_pack": 1,
      "product_type": "service",
      "language_code": "en",
      "unit_of_measure": "hour",
      "recurrence_type": "recurring"
    },
    "shipping": {
      "weight": null,
      "weight_unit": null,
      "height": null,
      "length": null,
      "width": null,
      "length_unit": null,
      "country_of_origin": null,
      "harmonized_system_code": null
    },
    "inventory": {
      "sku": "CONS-SEN-001"
    },
    "identifiers": {
      "crm": "crm_123",
      "accounting": "acc_789",
      "erp": "erp_456"
    },
    "accounting": {
      "ledger_account": "4010"
    },
    "primary_image_id": "cc0e8400-e29b-41d4-a716-446655440020",
    "parent_primary_image_id": "dd0e8400-e29b-41d4-a716-446655440021",
    "options": [
      {
        "option_id": "aa0e8400-e29b-41d4-a716-446655440010",
        "option_name": "Seniority",
        "option_api_name": "seniority",
        "value_id": "bb0e8400-e29b-41d4-a716-446655440011",
        "value_name": "Senior",
        "value_api_name": "senior"
      }
    ],
    "prices": [
      {
        "id": "ee0e8400-e29b-41d4-a716-446655440030",
        "key": "consulting_services_senior.standard",
        "pricebook": { "id": "ff0e8400-e29b-41d4-a716-446655440031", "name": "Standard", "api_name": "standard", "type": "fixed" },
        "billing_frequency": null,
        "pricing_model": "flat",
        "amount": 150
      }
    ],
    "created_at": "2024-12-21T10:30:00Z",
    "updated_at": "2024-12-21T10:30:00Z",
    "created_by": "aa1e8400-e29b-41d4-a716-446655440099",
    "updated_by": "aa1e8400-e29b-41d4-a716-446655440099"
  }
}

GET

api

products

{id}

Obtenir un produit

curl --request GET \
  --url https://qwoty.app/api/products/{id} \
  --header 'Authorization: <authorization>'

const options = {method: 'GET', headers: {Authorization: '<authorization>'}};

fetch('https://qwoty.app/api/products/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://qwoty.app/api/products/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://qwoty.app/api/products/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<authorization>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://qwoty.app/api/products/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "product_parent_id": "660e8400-e29b-41d4-a716-446655440001",
    "workspace_id": "880e8400-e29b-41d4-a716-446655440003",
    "name": "Consulting Services - Senior",
    "api_name": "consulting_services_senior",
    "reference": "SERV-001",
    "description": "Senior consultant hourly rate",
    "description_inherit_from_product": true,
    "primary_image_inherit_from_product": true,
    "is_active": true,
    "is_default": true,
    "catalogs": [
      {
        "id": "770e8400-e29b-41d4-a716-446655440002",
        "name": "Catalogue principal",
        "api_name": "catalog_main"
      }
    ],
    "categories": [],
    "settings": {
      "unit_per_pack": 1,
      "product_type": "service",
      "language_code": "en",
      "unit_of_measure": "hour",
      "recurrence_type": "recurring"
    },
    "shipping": {
      "weight": null,
      "weight_unit": null,
      "height": null,
      "length": null,
      "width": null,
      "length_unit": null,
      "country_of_origin": null,
      "harmonized_system_code": null
    },
    "inventory": {
      "sku": "CONS-SEN-001"
    },
    "identifiers": {
      "crm": "crm_123",
      "accounting": "acc_789",
      "erp": "erp_456"
    },
    "accounting": {
      "ledger_account": "4010"
    },
    "primary_image_id": "cc0e8400-e29b-41d4-a716-446655440020",
    "parent_primary_image_id": "dd0e8400-e29b-41d4-a716-446655440021",
    "options": [
      {
        "option_id": "aa0e8400-e29b-41d4-a716-446655440010",
        "option_name": "Seniority",
        "option_api_name": "seniority",
        "value_id": "bb0e8400-e29b-41d4-a716-446655440011",
        "value_name": "Senior",
        "value_api_name": "senior"
      }
    ],
    "prices": [
      {
        "id": "ee0e8400-e29b-41d4-a716-446655440030",
        "key": "consulting_services_senior.standard",
        "pricebook": { "id": "ff0e8400-e29b-41d4-a716-446655440031", "name": "Standard", "api_name": "standard", "type": "fixed" },
        "billing_frequency": null,
        "pricing_model": "flat",
        "amount": 150
      }
    ],
    "created_at": "2024-12-21T10:30:00Z",
    "updated_at": "2024-12-21T10:30:00Z",
    "created_by": "aa1e8400-e29b-41d4-a716-446655440099",
    "updated_by": "aa1e8400-e29b-41d4-a716-446655440099"
  }
}

Autorisation

string

requis

Jeton Bearer pour l’authentification. Format : Bearer qwoty_your_token

Paramètres de chemin

string

requis

UUID du produit

Exemples

curl https://qwoty.app/api/products/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer qwoty_your_token"

const productId = '550e8400-e29b-41d4-a716-446655440000'

const response = await fetch(`https://qwoty.app/api/products/${productId}`, {
  headers: {
    Authorization: 'Bearer qwoty_your_token',
  },
})

const data = await response.json()

import requests

product_id = '550e8400-e29b-41d4-a716-446655440000'

response = requests.get(
    f'https://qwoty.app/api/products/{product_id}',
    headers={
        'Authorization': 'Bearer qwoty_your_token'
    }
)

data = response.json()

Réponse

boolean

Indique si la requête a réussi

object

L’objet produit

Afficher Objet Produit

string

Identifiant unique (UUID)

string

ID du produit parent (UUID)

string

ID de l’espace de travail (UUID)

string

Nom du produit (nom d’affichage combinant le parent et les options de variante)

string

Identifiant API (uniquement à la création)

string

Référence interne

string

Description du produit

boolean

Indique si la description est héritée du produit parent

boolean

Indique si l’image principale est héritée du produit parent

boolean

Statut actif

boolean

Indique s’il s’agit du produit par défaut

array

Catalogues liés au produit

Afficher Catalog Entry

string

ID du catalogue (UUID)

string

Nom du catalogue

string

Nom API du catalogue

array

Catégories liées au produit parent

Afficher Entrée catégorie

string

ID de la catégorie (UUID)

string

Nom API de la catégorie

object

Paramètres et configuration du produit

Afficher Objet Paramètres

number

Nombre d’unités par pack

string

Type de produit parent

string

Code langue du parent (ex. en, fr)

string

Unité de mesure parent

string

Type de récurrence parent (one_off ou recurring)

object

Informations d’expédition

Afficher Objet Expédition

number

Poids d’expédition

string

Unité de poids d’expédition (kg, lbs)

number

Hauteur d’expédition

number

Longueur d’expédition

number

Largeur d’expédition

string

Unité de longueur d’expédition (cm, in, etc.)

string

Pays d’origine pour l’expédition

string

Code SH pour les douanes

object

Informations de stock

Afficher Objet Inventaire

string

Unité de gestion des stocks (SKU)

object

Identifiants de systèmes externes

Afficher Objet Identifiants

string

ID CRM externe

string

ID comptable externe

string

ID ERP externe

object

Informations comptables

Afficher Objet Comptabilité

string

Code du compte du grand livre

string

UUID du média principal de ce produit. Null si aucun n’est défini. Lorsque primary_image_inherit_from_product est true et que ce champ est null, utiliser parent_primary_image_id comme image effective.

string

UUID du média principal du produit parent. Lecture seule. Utile lorsque primary_image_inherit_from_product est true.

array

Valeurs des options de variante (ex. : couleur, taille)

Afficher Objet Option

string

ID de définition de l’option

string

Nom de l’option (ex. : “Couleur”)

string

Nom API de l’option

string

ID de la valeur d’option

string

Valeur de l’option (ex. : “Bleu”)

string

Nom API de la valeur

array

Prix associés à ce produit dans tous les catalogues de prix

Afficher Entrée de prix

string

ID du prix (UUID)

string | null

Clé sémantique du prix (<product_api_name>.<pricebook_api_name>[.<unit>.<period>]), même valeur que key sur /prices et que la colonne id de l’import CSV des prix

object

Catalogue de prix de ce prix

Afficher Pricebook

string

ID du catalogue de prix (UUID)

string

Nom du catalogue de prix

string

Nom API du catalogue de prix

string

Type du catalogue de prix (fixed ou dynamic)

object | null

Fréquence de facturation ({ id, period, unit }), null pour un prix ponctuel

string

Modèle de tarification (flat, volume, graduated, percent, cost_based, none)

number | null

Prix unitaire. Renseigné uniquement quand pricing_model vaut flat, sinon null.

string

Horodatage ISO 8601

string

Horodatage ISO 8601

string

ID de l’utilisateur ayant créé le produit

string

ID de l’utilisateur ayant mis à jour le produit en dernier

{
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "product_parent_id": "660e8400-e29b-41d4-a716-446655440001",
    "workspace_id": "880e8400-e29b-41d4-a716-446655440003",
    "name": "Consulting Services - Senior",
    "api_name": "consulting_services_senior",
    "reference": "SERV-001",
    "description": "Senior consultant hourly rate",
    "description_inherit_from_product": true,
    "primary_image_inherit_from_product": true,
    "is_active": true,
    "is_default": true,
    "catalogs": [
      {
        "id": "770e8400-e29b-41d4-a716-446655440002",
        "name": "Catalogue principal",
        "api_name": "catalog_main"
      }
    ],
    "categories": [],
    "settings": {
      "unit_per_pack": 1,
      "product_type": "service",
      "language_code": "en",
      "unit_of_measure": "hour",
      "recurrence_type": "recurring"
    },
    "shipping": {
      "weight": null,
      "weight_unit": null,
      "height": null,
      "length": null,
      "width": null,
      "length_unit": null,
      "country_of_origin": null,
      "harmonized_system_code": null
    },
    "inventory": {
      "sku": "CONS-SEN-001"
    },
    "identifiers": {
      "crm": "crm_123",
      "accounting": "acc_789",
      "erp": "erp_456"
    },
    "accounting": {
      "ledger_account": "4010"
    },
    "primary_image_id": "cc0e8400-e29b-41d4-a716-446655440020",
    "parent_primary_image_id": "dd0e8400-e29b-41d4-a716-446655440021",
    "options": [
      {
        "option_id": "aa0e8400-e29b-41d4-a716-446655440010",
        "option_name": "Seniority",
        "option_api_name": "seniority",
        "value_id": "bb0e8400-e29b-41d4-a716-446655440011",
        "value_name": "Senior",
        "value_api_name": "senior"
      }
    ],
    "prices": [
      {
        "id": "ee0e8400-e29b-41d4-a716-446655440030",
        "key": "consulting_services_senior.standard",
        "pricebook": { "id": "ff0e8400-e29b-41d4-a716-446655440031", "name": "Standard", "api_name": "standard", "type": "fixed" },
        "billing_frequency": null,
        "pricing_model": "flat",
        "amount": 150
      }
    ],
    "created_at": "2024-12-21T10:30:00Z",
    "updated_at": "2024-12-21T10:30:00Z",
    "created_by": "aa1e8400-e29b-41d4-a716-446655440099",
    "updated_by": "aa1e8400-e29b-41d4-a716-446655440099"
  }
}

Réponses d’erreur

{
  "success": false,
  "error": "Product not found"
}

{
  "success": false,
  "error": "Invalid or expired token"
}

{
  "success": false,
  "error": "Invalid product ID format"
}

Notes

Cet endpoint permet d’accéder directement à un produit en utilisant uniquement l’ID du produit. Pour accéder aux produits via leur produit parent, vous pouvez également utiliser :

GET /api/product-parents/{id}/products/{product_id}

Dernière modification le 28 octobre 2026

Catalogues

Catégories

Produits parents

Produits

Prix

Conditions de paiement

Clients

Contacts

Adresses

Devis

Médias

Jetons

Obtenir un produit

Autorisation

Paramètres de chemin

Exemples

Réponse

Réponses d’erreur

Notes

​Autorisation

​Paramètres de chemin

​Exemples

​Réponse

​Réponses d’erreur

​Notes

Autorisation

Paramètres de chemin

Exemples

Réponse

Réponses d’erreur

Notes