SDK's

Elke SDK wordt gegenereerd uit hetzelfde OpenAPI-document als de API-reference, met daarbovenop een dunne handgeschreven laag voor idempotentie, problem+json-fouten, retries en webhook-verificatie.

TypeScript

npm install @freightapi/sdk

import { FreightApi, FreightApiError } from '@freightapi/sdk'

const freight = new FreightApi({
  apiKey: process.env.FREIGHTAPI_KEY!,
  baseUrl: 'https://api.eftisandbox.app',
  locale: 'nl',
})

try {
  const shipment = await freight.shipments.retrieve('shp_...')
  console.log(shipment.status)
} catch (error) {
  if (error instanceof FreightApiError) {
    console.error(error.status, error.code, error.requestId)
  }
}

Draait op Node 22+, Bun, Deno, Cloudflare Workers en in de browser. Geen runtime-dependencies. Elke POST krijgt automatisch een Idempotency-Key, en 429 en 503 worden opnieuw geprobeerd.

.NET

Onderweg

De officiële .NET-SDK komt met M3-17. Tot die tijd is Cargofollow een gewone REST-API: genereer zelf een client uit /openapi.json met NSwag of Kiota, of gebruik HttpClient met System.Text.Json zoals in de quickstart.

Andere talen

Er is geen officiële client voor Python, Java, PHP of Go. Het OpenAPI-document is 3.1 en compleet, dus generatoren als openapi-generator of openapi-python-client leveren een werkende client:

curl -o openapi.json https://api.eftisandbox.app/openapi.json