Skip to main content
Utilisez SDK lorsque votre intégration est écrite en TypeScript ou JavaScript et s’exécute sur un serveur.

​
Installer

pnpm add plato-api-sdk
Utilisez le gestionnaire de packages que votre projet utilise déjà : 
npm install plato-api-sdk
yarn add plato-api-sdk
bun add plato-api-sdk

​
Créer un client

import { createPlatoApiClient } from "plato-api-sdk";

export const plato = createPlatoApiClient({
  baseUrl: "https://api.plato.ae",
  apiKey: process.env.PLATO_API_KEY,
});
Le SDK accepte soit l’origine API, soit le point de terminaison tRPC complet : 
createPlatoApiClient({
  baseUrl: "https://api.plato.ae",
  apiKey: process.env.PLATO_API_KEY,
});

createPlatoApiClient({
  baseUrl: "https://api.plato.ae/api/trpc",
  apiKey: process.env.PLATO_API_KEY,
});

​
Première demande

const feed = await plato.v1.orders.externalOrderFeed.query({
  apiKey: process.env.PLATO_API_KEY,
  date: "2026-06-17",
});

console.log(feed.count);
La plupart des routes de clé SDK API lisent la clé à partir de l’en-tête d’autorisation créé par SDK. Certaines routes conservent également un champ de saisie apiKey pour des raisons de compatibilité. En cas de doute, transmettez la clé au client SDK et suivez les exemples de saisie dans chaque page API.

​
Désactiver le traitement par lots

Le SDK regroupe les requêtes par défaut. Si un environnement ou un proxy rencontre des problèmes avec les requêtes tRPC par lots, désactivez le traitement par lots : 
const plato = createPlatoApiClient({
  baseUrl: "https://api.plato.ae",
  apiKey: process.env.PLATO_API_KEY,
  batch: false,
});

​
En-têtes personnalisés

Utilisez headers lorsque votre environnement a besoin d’en-têtes de requête supplémentaires. 
const plato = createPlatoApiClient({
  baseUrl: "https://api.plato.ae",
  apiKey: process.env.PLATO_API_KEY,
  headers: {
    "x-request-source": "my-integration",
  },
});
Le SDK maintient l’en-tête de clé API en place.