
Samsas för utvecklare
In EnglishLäs ert hushålls vecka, middagar, listor, nedräkningar och barnens poäng från egna skript, hemautomation eller en egen skärm. Bara läsning än så länge; samma smala bild som skärmen och Home Assistant – aldrig hur någon mår, burken, cykeln eller pengar.
Dina nycklar
…
Gränser
| per timme | per dygn | |
|---|---|---|
| Gratis | 60 | 500 |
| Samsas Plus | 600 | 10000 |
Räknas per hushåll, över alla nycklar. Svaret säger hur många anrop som är kvar (X-RateLimit-Remaining); vid 429 står i Retry-After när ni kan fortsätta.
Anrop
GET /api/v1/me | The key, its household and who is in it |
GET /api/v1/today | Today: events, dinner, name days and holidays, swap requests |
GET /api/v1/events | Events, bin and post days, and a shared child's weeks, for a span of up to 93 days |
GET /api/v1/menu | The week's dinners, Monday to Sunday |
GET /api/v1/lists | The shopping list, the week's list, the to-do list and your own lists |
GET /api/v1/countdowns | Birthdays, anniversaries and events worth counting down to |
GET /api/v1/kids | Per child: where they are this week, their points and this week's chores |
GET /api/v1/notices | Bin and post days and list deadlines, from today |
Exempel
curl -H "Authorization: Bearer sams_…" https://samsas.app/api/v1/today