FluentaAPI

List categories

listCategoriesPermiso read

The «Categorías» an OC takes its garment from: the plant’s own, for «Otros clientes», and those of each brand it works for in the «Red de talleres».

GET/v1/external/organizations/{organizationId}/categories

Answers the «Categorías de prenda» of «Configuración»: the kinds of garment (blusa, pantalón…) a «referencia» (an OC) is, which production figures are added up by.

own is the plant’s own list, plain names, for the OCs of its own clients («Otros clientes»). brands holds one group per brand («cuenta de marca») the plant works for in the «Red de talleres»: its companyAdminId, its name and its numbered catalogue (code «01», short «Blusa», name «Blusa · Vestido»). Both are empty for a plant that keeps no list and works for no brand.

Feed it to the «Programa»: the garment of createReference and updateReference takes one name of own, and a «referencia» read back (getProgram, getReference) carries the same string.

No id beyond organizationId; no time field; the read creates nothing.

Not paged: the whole answer comes in one response.

Plan: on every plan, Light included. A «token de API» reads it in any organization the user who created it belongs to; a connected AI app (a «conexión») reads it only where the organization has «Conectar con IA» (getPlan.features.aiConnector, a Pro feature), and answers 403 PLAN_LIMIT elsewhere.

Rate limit: one request of the credential’s ordinary budget in this organization (getPlan answers the numbers); past it, 429 RATE_LIMITED with Retry-After in seconds.

Autorización

apiToken
AutorizaciónBearer <token>

An API token created in Configuración › Tokens de API, or a connected app’s access token

En: header

Parámetros de ruta

organizationId*integer

The organization, from getMe or listOrganizations.

Respuestas

application/json

application/json

curl -X GET "https://api.fluenta.io/v1/external/organizations/0/categories" \  -H "Authorization: Bearer fluenta_live_XXXX"
{  "own": [    "string"  ],  "brands": [    {      "companyAdminId": 0,      "name": "string",      "categories": [        {          "code": "01",          "short": "Blusa",          "name": "Blusa · Vestido",          "emoji": "string"        }      ]    }  ]}