SDK oficial · v0.2.0TypeScript / Node.js
Tipus complets, async/await i automatismes preparats per a Node 20 o superior.
Instal·lar
npm install @factuarea/sdkSDK oficials
Integra Factuarea amb TypeScript o PHP.
Clients oficials per al teu backend, amb reintents, idempotència i paginació ja resolts.
- Node 20 o superior
- PHP 8.2 o superior
- Sandbox amb clau fact_test_
Integracions i formats compatibles
WhatsApp
SDK oficial · v0.2.0
SDK oficial · v0.2.0PHP
PSR-4 sobre Guzzle, errors clars i suport per a PHP 8.2 o superior.
Instal·lar
composer require factuarea/factuarea-phpQuè hi ha a dins
Reintents, idempotència i paginació inclosos
La teva aplicació fa una crida. L'SDK s'ocupa que arribi una sola vegada i de recuperar la resposta correcta.
- ReintentsRespecta Retry-After i recupera automàticament les fallades transitòries.
- IdempotènciaCada operació porta una clau perquè repetir-la no dupliqui una factura.
- Paginació per cursorRecorre next_cursor fins a completar la col·lecció, sense bucles manuals.
TypeScriptv0.2.0PHPv0.2.0Factuarea SDKinvoices.create(factura)
201 CreatedFRA 2026/0184
✓ Reintents✓ Idempotència✓ Paginació per cursor
Les capçaleres
Autenticació i capçaleres gestionades per l'SDK
Escriure menys codi és l'argument fàcil. El que es nota és aquest: deixar de recordar-te'n. Cadascuna d'aquestes capçaleres té una conseqüència si s'oblida, i l'SDK les posa i les llegeix per tu.
- Idempotency-KeyGenerada per a cada mutació. És el que fa que un reintent no acabi en dues factures.
- Retry-AfterQuan arriba un 429, l'SDK espera el que digui aquesta capçalera abans de tornar-ho a provar.
- Factuarea-VersionLa versió que fixa el release que tens instal·lat. L'API es comporta igual fins que actualitzes.
TypeScriptPHPFactuarea SDKruntime.request()
- AuthorizationwriteBearer fact_live_…
- Idempotency-Keywrite0192…1d4b
- Factuarea-Versionwrite2026-06-01
- Retry-Afterread12
- X-Request-Idreadreq_01…
- Factuarea-Signaturereadt=… v1=…
L'SDK va al servidor. Sempre.
La clau és un secret: no la portis a un navegador, a una app mòbil ni a cap client públic.
OpenAPI 3.1
Un contracte públic per generar el teu propi client
Genera un client per al teu llenguatge des de la mateixa especificació que publica l'API.
- Tipus sempre alineatsModels i operacions surten directament d'OpenAPI 3.1.
- El teu llenguatge també hi entraTypeScript, Python, Go, Java, C# i Rust, entre d'altres.
- Tu tries el runtimeAfegeix reintents i idempotència seguint les guies de Factuarea.
OpenAPI 3.1openapi.json✓ Tipus sempre alineats✓ El teu llenguatge també hi entra✓ Tu tries el runtime
docs.factuarea.com/api/openapiSuperfície publicada
Una integració que encaixa amb el teu stack
El contracte OpenAPI, els SDK i el servidor MCP parteixen de la mateixa API. Les xifres es revisen contra la superfície publicada perquè puguis avaluar l'abast i el manteniment abans d'integrar.
- operacions API
- 413
- recursos
- 37
- eines MCP
- 391
- pàgines de documentació
- 797
Tecnologies i clients compatibles
- TypeScript
- PHP
OpenAPI
Cursor
Els logotips identifiquen tecnologies o clients compatibles; no impliquen una relació comercial ni un testimoni.
Dubtes
El que es pregunta abans de fixar la dependència
Sí que el pots fer servir. Fins a l'1.0.0 una versió menor pot portar canvis incompatibles, així que fixa-la al lockfile. Cada release ancora una Factuarea-Version i l'API no canvia fins que tu actualitzes.
Instal·la'l, apunta al sandbox i emet una factura
Amb una clau fact_test_ no s'envia res enlloc. Quan surti, canvies el prefix.