Listează categoriile

Întoarce arborele de categorii aplatizat, în ordinea în care îl afișează ThinkOut: încasările mai întâi, apoi plățile, iar în fiecare direcție fiecare categorie de nivel superior urmată imediat de copiii ei. Categoriile de pe același nivel urmează position. Citită de sus în jos, pagina redă așadar ecranul de categorii al produsului. direction restrânge la unul dintre cele două panouri.

Reconstruiește ierarhia cu parent_id și resortează după position în cadrul fiecărui parent_id dacă ai nevoie din nou de ordine după ce ai stocat rândurile.

Arborele are exact două niveluri. O categorie cu parent_id nu are niciodată copii proprii, iar ambele niveluri pot apărea pe o tranzacție. direction și activity ale unui copil coincid întotdeauna cu ale rădăcinii lui.

GET

categories

Listează categoriile

curl --request GET \
  --url https://api.thinkout.io/v1/categories \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.thinkout.io/v1/categories', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "object": "list",
  "data": [
    {
      "object": "category",
      "id": "3b4c5d6e-7f80-4a1b-9c2d-3e4f5a6b7c8d",
      "name": "Telecom",
      "code": null,
      "direction": "outflow",
      "activity": "operating",
      "parent_id": "6a7b8c9d-0e1f-4a2b-8c3d-4e5f6a7b8c9d",
      "position": 2,
      "color": "#1b7fe4",
      "created_at": "2024-01-01T10:00:00Z",
      "updated_at": "2024-01-01T10:00:00Z"
    }
  ],
  "has_more": true,
  "next_cursor": "<string>"
}

{
  "error": {
    "type": "invalid_request",
    "code": "invalid_parameter",
    "message": "Parameter 'from' must be a date in YYYY-MM-DD format.",
    "param": "from",
    "request_id": "req_01J8ZT4Q7Y6M3K"
  }
}

{
  "error": {
    "type": "authentication",
    "code": "unauthorized",
    "message": "Invalid API key.",
    "param": null,
    "request_id": "req_01J8ZT4Q7Y6M3K"
  }
}

{
  "error": {
    "type": "rate_limit",
    "code": "rate_limited",
    "message": "Rate limit exceeded. Retry after 12 seconds.",
    "param": null,
    "request_id": "req_01J8ZT4Q7Y6M3K"
  }
}

Autorizări

Authorization

string

header

obligatoriu

O cheie API creată în setările ThinkOut. O cheie citește un singur spațiu de lucru.

Parametri interogare

direction

enum<string>

Dacă banii intră sau ies. Pe o tranzacție sau pe o previziune urmează semnul lui amount și nu îl poate contrazice niciodată. Există ca răspunsurile să poată fi grupate și citite fără să inspectezi semnele.

Opțiuni disponibile:

inflow,

outflow

limit

integer

implicit:100

Dimensiunea paginii.

Interval necesar: 1 <= x <= 500

cursor

string

Token opac din next_cursor al paginii anterioare.

Răspuns

O pagină de categorii.

object

string

obligatoriu

Allowed value: "list"

data

object[]

obligatoriu

Show child attributes

has_more

boolean

obligatoriu

Dacă mai există o pagină.

next_cursor

string | null

obligatoriu

Trimite-l ca cursor pentru pagina următoare. null pe ultima pagină.

⌘I

Listează categoriile

curl --request GET \
  --url https://api.thinkout.io/v1/categories \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.thinkout.io/v1/categories', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "object": "list",
  "data": [
    {
      "object": "category",
      "id": "3b4c5d6e-7f80-4a1b-9c2d-3e4f5a6b7c8d",
      "name": "Telecom",
      "code": null,
      "direction": "outflow",
      "activity": "operating",
      "parent_id": "6a7b8c9d-0e1f-4a2b-8c3d-4e5f6a7b8c9d",
      "position": 2,
      "color": "#1b7fe4",
      "created_at": "2024-01-01T10:00:00Z",
      "updated_at": "2024-01-01T10:00:00Z"
    }
  ],
  "has_more": true,
  "next_cursor": "<string>"
}

{
  "error": {
    "type": "invalid_request",
    "code": "invalid_parameter",
    "message": "Parameter 'from' must be a date in YYYY-MM-DD format.",
    "param": "from",
    "request_id": "req_01J8ZT4Q7Y6M3K"
  }
}

{
  "error": {
    "type": "authentication",
    "code": "unauthorized",
    "message": "Invalid API key.",
    "param": null,
    "request_id": "req_01J8ZT4Q7Y6M3K"
  }
}

{
  "error": {
    "type": "rate_limit",
    "code": "rate_limited",
    "message": "Rate limit exceeded. Retry after 12 seconds.",
    "param": null,
    "request_id": "req_01J8ZT4Q7Y6M3K"
  }
}

Primii pași

Lucrul cu datele

MCP

Referință API

Listează categoriile

Autorizări

Parametri interogare

Răspuns