API per a Desenvolupadors

Integra el teu sistema amb Totaki

L'API de Totaki permet sincronitzar productes, gestionar estoc i rebre comandes directament al teu sistema. Ideal per a botigues amb ERP o POS propis.

Autenticació

Totes les peticions a l'API requereixen una clau API. Envia-la a la capçalera X-API-Key:

X-API-Key: your_api_key_here

Pots generar claus API des del Business Hub de la teva empresa.

Endpoints disponibles

POST
/api/external/sync-products

Sincronitza productes des del teu sistema. Crea o actualitza productes automàticament.

curl -X POST https://api.totaki.app/api/external/sync-products \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "products": [
    {
      "external_id": "SKU-001",
      "name": "Samarreta ecologica",
      "description": "100% cotó organic",
      "price": 29.99,
      "stock": 50,
      "sku": "SKU-001"
    }
  ]
}'
POST
/api/external/sync-stock

Actualitza l'estoc de múltiples productes alhora.

curl -X POST https://api.totaki.app/api/external/sync-stock \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "updates": [
    { "external_id": "SKU-001", "stock": 45 }
  ]
}'
GET
/api/external/orders

Obté les comandes rebudes per les botigues de la teva empresa.

curl https://api.totaki.app/api/external/orders?status=pending \
  -H "X-API-Key: YOUR_KEY"
GET
/api/external/products

Llista tots els productes de la teva empresa.

curl https://api.totaki.app/api/external/products \
  -H "X-API-Key: YOUR_KEY"

Exemple amb JavaScript

const API_KEY = 'your_api_key';
const BASE = 'https://api.totaki.app';

// Sync products
const res = await fetch(`${BASE}/api/external/sync-products`, {
  method: 'POST',
  headers: {
    'X-API-Key': API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    products: [
      { external_id: 'P1', name: 'Producte 1', price: 19.99, stock: 10 }
    ]
  }),
});
const data = await res.json();
console.log(data); // { accepted: 1, rejected: [], conflicts: [] }

Límits de peticions

Per garantir la qualitat del servei, l'API té els següents límits:

  • 30 peticions per minut per clau API
  • 500 productes màxim per sincronització
  • Les respostes inclouen capçaleres de límit restant

Vols integrar la teva botiga amb Totaki?

Registra la teva empresa