API Reference

Kirjapro käyttää Supabase Edge Functions -arkkitehtuuria (Deno runtime).

Base URL

https://<project-ref>.supabase.co/functions/v1/<function-name>

Useimmat endpointit vaativat JWT Bearer -tokenin.

Vaaditut headerit:

Authorization: Bearer <access_token>
Content-Type: application/json
apikey: <supabase_anon_key>

Lähettää verkkolaskun Maventan kautta Finvoice 3.0 -muodossa.

Ominaisuus	Arvo
Endpoint	`POST /functions/v1/send-einvoice`
Auth	JWT Bearer token
Rate limit	10 req/min per user

Vastaanottaa toimitusilmoitukset Mavennalta.

Ominaisuus	Arvo
Endpoint	`POST /functions/v1/maventa-webhook`
Auth	HMAC-SHA256 signature
Rate limit	100 req/min

Generoi tuloslaskelman PDF-muodossa.

Ominaisuus	Arvo
Endpoint	`POST /functions/v1/generate-income-statement-pdf`
Auth	JWT Bearer token
Rate limit	20 req/min

Generoi taseen PDF-muodossa.

Ominaisuus	Arvo
Endpoint	`POST /functions/v1/generate-balance-sheet-pdf`
Auth	JWT Bearer token
Rate limit	20 req/min

Luo Stripe Checkout -session tilauksen päivittämiseen.

Ominaisuus	Arvo
Endpoint	`POST /functions/v1/create-checkout-session`
Auth	JWT Bearer token
Rate limit	5 req/min

Request:

{
  "priceId": "price_xxx",
  "companyId": "uuid"
}

Response:

{
  "success": true,
  "checkoutUrl": "https://checkout.stripe.com/..."
}

Luo Stripe Customer Portal -session tilauksen hallintaan.

Ominaisuus	Arvo
Endpoint	`POST /functions/v1/create-portal-session`
Auth	JWT Bearer token
Rate limit	5 req/min

Vastaanottaa Stripe-tapahtumat (checkout, subscription, invoice).

Ominaisuus	Arvo
Endpoint	`POST /functions/v1/stripe-webhook`
Auth	Stripe signature verification
Rate limit	None

Code	Merkitys
400	Bad Request - virheellinen pyyntö
401	Unauthorized - autentikointi puuttuu
403	Forbidden - ei oikeuksia
404	Not Found - resurssia ei löydy
429	Too Many Requests - rate limit ylitetty
500	Internal Server Error - palvelinvirhe