Lister les produits

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

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

fetch('https://qwoty.app/api/products', 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",
  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"

	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")

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

{
  "total": 42,
  "next": "https://qwoty.app/api/products?limit=30&page=2",
  "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": null,
        "accounting": null,
        "erp": null
      },
      "accounting": {
        "ledger_account": null
      },
      "options": [
        {
          "option_id": "opt-001",
          "option_name": "Seniority",
          "option_api_name": "seniority",
          "value_id": "val-001",
          "value_name": "Senior",
          "value_api_name": "senior"
        }
      ],
      "prices": [
        {
          "id": "price-001",
          "key": "consulting_services_senior.standard",
          "pricebook": { "id": "pb-001", "name": "Standard", "api_name": "standard", "type": "fixed" },
          "billing_frequency": null,
          "pricing_model": "flat",
          "amount": 150
        }
      ],
      "primary_image_id": null,
      "parent_primary_image_id": null,
      "created_at": "2024-12-21T10:30:00Z",
      "updated_at": "2024-12-21T10:30:00Z"
    }
  ]
}

GET

api

products

Lister les produits

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

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

fetch('https://qwoty.app/api/products', 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",
  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"

	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")

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

{
  "total": 42,
  "next": "https://qwoty.app/api/products?limit=30&page=2",
  "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": null,
        "accounting": null,
        "erp": null
      },
      "accounting": {
        "ledger_account": null
      },
      "options": [
        {
          "option_id": "opt-001",
          "option_name": "Seniority",
          "option_api_name": "seniority",
          "value_id": "val-001",
          "value_name": "Senior",
          "value_api_name": "senior"
        }
      ],
      "prices": [
        {
          "id": "price-001",
          "key": "consulting_services_senior.standard",
          "pricebook": { "id": "pb-001", "name": "Standard", "api_name": "standard", "type": "fixed" },
          "billing_frequency": null,
          "pricing_model": "flat",
          "amount": 150
        }
      ],
      "primary_image_id": null,
      "parent_primary_image_id": null,
      "created_at": "2024-12-21T10:30:00Z",
      "updated_at": "2024-12-21T10:30:00Z"
    }
  ]
}

Autorisation

string

requis

Token Bearer pour l’authentification. Format : Bearer qwoty_your_token

Paramètres de requête

integer

défaut:"30"

Nombre de résultats par page (max 200)

integer

défaut:"1"

Numéro de page (base 1)

string

Filtrer par identifiant externe. Correspond à identifiers.erp, identifiers.crm et identifiers.accounting.

string

Filtrer par nom d’API exact

string

Filtrer par SKU (inventory.sku)

string

Filtrer par référence interne

Exemples

curl https://qwoty.app/api/products \
  -H "Authorization: Bearer qwoty_your_token"

curl "https://qwoty.app/api/products?limit=30&sku=CONS-SEN-001" \
  -H "Authorization: Bearer qwoty_your_token"

const response = await fetch('https://qwoty.app/api/products?limit=30', {
  headers: {
    Authorization: 'Bearer qwoty_your_token',
  },
})

const data = await response.json()

import requests

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

data = response.json()

Réponse

integer

Nombre total de produits correspondant à la requête (sur toutes les pages)

string | null

URL pour récupérer la page suivante, ou null s’il s’agit de la dernière page

array

Tableau d’objets produit pour la page courante

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 les options parent + variante)

string

Identifiant API

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 si ce produit est le produit par défaut sous son parent

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

object

Informations d’expédition

object

Informations d’inventaire

object

Identifiants des systèmes externes

object

Informations comptables

array

Valeurs d’options pour ce produit (ex. : couleur, taille)

Afficher Objet Option

string

ID de définition de l’option (UUID)

string

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

string

Nom API de l’option

string

ID de la valeur de l’option (UUID)

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

UUID du média principal de ce produit. Null si aucun n’est défini.

string

UUID du média principal du produit parent. Lecture seule.

{
  "total": 42,
  "next": "https://qwoty.app/api/products?limit=30&page=2",
  "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": null,
        "accounting": null,
        "erp": null
      },
      "accounting": {
        "ledger_account": null
      },
      "options": [
        {
          "option_id": "opt-001",
          "option_name": "Seniority",
          "option_api_name": "seniority",
          "value_id": "val-001",
          "value_name": "Senior",
          "value_api_name": "senior"
        }
      ],
      "prices": [
        {
          "id": "price-001",
          "key": "consulting_services_senior.standard",
          "pricebook": { "id": "pb-001", "name": "Standard", "api_name": "standard", "type": "fixed" },
          "billing_frequency": null,
          "pricing_model": "flat",
          "amount": 150
        }
      ],
      "primary_image_id": null,
      "parent_primary_image_id": null,
      "created_at": "2024-12-21T10:30:00Z",
      "updated_at": "2024-12-21T10:30:00Z"
    }
  ]
}

Réponses d’erreur

{
  "error": "Invalid or expired token"
}

Dernière modification le 28 octobre 2026

Catalogues

Catégories

Produits parents

Produits

Prix

Conditions de paiement

Clients

Contacts

Adresses

Devis

Médias

Jetons

Lister les produits

Autorisation

Paramètres de requête

Exemples

Réponse

Réponses d’erreur

​Autorisation

​Paramètres de requête

​Exemples

​Réponse

​Réponses d’erreur

Autorisation

Paramètres de requête

Exemples

Réponse

Réponses d’erreur