Documentation de l'API

Authentification

Chaque requête porte une clé API dans l'en-tête Authorization: Bearer qrt_live_.... Crée tes clés dans Paramètres, API, avec une portée lecture seule ou lecture et écriture. Les clés qrt_test_ créent de vrais codes, hors quota, visibles seulement avec une clé de test.

Limites

60 requêtes par minute et 50 000 par mois et par compte. Les en-têtes X-RateLimit-* indiquent ta consommation ; au-delà, l'API répond 429.

Adresse de base

https://qrtada.com/api/public/v1

Points d'accès

Exemples

GET /codes : lister les codes

cURL

curl -X GET "https://qrtada.com/api/public/v1/codes?limit=30" \
  -H "Authorization: Bearer $QRTADA_API_KEY"

JavaScript

const res = await fetch("https://qrtada.com/api/public/v1/codes?limit=30", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.QRTADA_API_KEY}`,
  },
});
const { data } = await res.json();

Python

import os, requests

res = requests.get(
    "https://qrtada.com/api/public/v1/codes?limit=30",
    headers={"Authorization": f"Bearer {os.environ['QRTADA_API_KEY']}"},
)
data = res.json()["data"]

POST /codes : créer un code

cURL

curl -X POST "https://qrtada.com/api/public/v1/codes" \
  -H "Authorization: Bearer $QRTADA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Menu du midi","kind":"dynamic","type":"url","content":{"url":"https://chezpaul.fr/menu"}}'

JavaScript

const res = await fetch("https://qrtada.com/api/public/v1/codes", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.QRTADA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"name":"Menu du midi","kind":"dynamic","type":"url","content":{"url":"https://chezpaul.fr/menu"}}),
});
const { data } = await res.json();

Python

import os, requests

res = requests.post(
    "https://qrtada.com/api/public/v1/codes",
    headers={"Authorization": f"Bearer {os.environ['QRTADA_API_KEY']}"},
    json={"name":"Menu du midi","kind":"dynamic","type":"url","content":{"url":"https://chezpaul.fr/menu"}},
)
data = res.json()["data"]

Télécharger la spécification OpenAPI