Dostęp API
Uwierzytelnianie
Zaloguj się na squeevio.com i otwórz Dostęp API w panelu bocznym (/api-tokens). Nadaj tokenowi nazwę, wybierz uprawnienia i skopiuj sekret — jest pokazany dokładnie raz.
Każde żądanie uwierzytelniasz nagłówkiem:
Authorization: Bearer skz_...Odwołany, wygasły lub bez wymaganego uprawnienia token dostaje 401; token bez odpowiedniego zakresu — 403. Sprawdź pole error w odpowiedzi JSON.
Uprawnienia (scopes)
| Scope | Dostęp |
|---|---|
| orbio_read | Odczyt grup Circlio, kontaktów, celów, awatarów |
| orbio_write | Powyższe + zapis grup i parsowanie listy importu |
| read_mood | Odczyt wpisów samopoczucia |
| read_gratitude | Odczyt wpisów wdzięczności |
| read_urge | Odczyt dziennika pokus |
| read_tool_use | Odczyt użycia narzędzi |
| read_all | Wszystkie powyższe read_* naraz (nie obejmuje orbio_write — token tylko-do-odczytu nigdy nie zapisuje). |
orbio_read/orbio_write są celowo osobną parą, nie częścią read_all: token do integracji z Circlio nigdy nie odblokowuje danych samopoczucia/wdzięczności/pokus, i odwrotnie.
Squeevio — odczyt danych
Cztery endpointy tylko do odczytu, każdy przyjmuje opcjonalny parametr ?days=N (domyślnie 30, maks. 365):
GET https://api.squeevio.com/api/v1/mood?days=30
GET https://api.squeevio.com/api/v1/gratitude?days=30
GET https://api.squeevio.com/api/v1/urge?days=30
GET https://api.squeevio.com/api/v1/tool-use?days=30{"ok": true, "entries": [...], "days": 30}Circlio — pełne zarządzanie
Circlio (grupy kontaktów i cele rozmów) udostępnia pełny odczyt i zapis przez te same tokeny — zobacz Circlio i jego dedykowaną dokumentację API ze wszystkimi przykładami requestów.
Zarządzanie tokenami
Tworzenie i odwoływanie tokenów wymaga prawdziwej zalogowanej sesji, nie tokenu osobistego — celowo nie można delegować tego uprawnienia do innego tokenu.
GET /panel/api/me/tokens
POST /panel/api/me/tokens
DELETE /panel/api/me/tokens/<id>Pytania o API? support@squeevio.com