PT EN

Próximos passos

URL base: $PUBLIC_API

O objecto

audiencestring · obrigatório

um de platform, business, consumer, resident

localestring · obrigatório

um de pt-MZ, en-US

generated_atstring (date-time) · obrigatório
stepsarray of NextStep · obrigatório
Mostrar atributos filhos
idstring · obrigatório
journey_idstring · obrigatório
titlestring · obrigatório
linestring · obrigatório
statestring · obrigatório

um de todo, blocked

ownerstring · obrigatório

um de you, platform_review, team_member, utility_owner

actionobject · opcional
Mostrar atributos filhos
idstring · obrigatório

Portable destination intent each client maps to its own screen

labelstring · opcional

Localized action label

routestring · opcional

In-app route on the platform dashboard (platform setup only)

helpobject · obrigatório
Mostrar atributos filhos
article_idstring · obrigatório

Help registry category/slug

blocked_reasonobject · obrigatório · anulável
Mostrar atributos filhos
codestring · opcional
messagestring · opcional
wait_linestring · opcional

Optional, localized like line. On the utility's review step (documents) until approval: how long the platform's review usually takes. Present only when the server has a figure: the median of past decided reviews once there are at least 3, else the configured onboarding.review_wait (default 0, meaning absent).

doorsarray of NextStepChoice · opcional

The two resident entry doors (public entry only)

Mostrar atributos filhos
idstring · obrigatório
titlestring · obrigatório
linestring · obrigatório
helpobject · obrigatório
Mostrar atributos filhos
article_idstring · obrigatório
actionsarray of NextStepChoice · opcional

Public utility lookup and request-status actions (public entry only)

Mostrar atributos filhos
idstring · obrigatório
titlestring · obrigatório
linestring · obrigatório
helpobject · obrigatório
Mostrar atributos filhos
article_idstring · obrigatório
run_tokenstring · opcional

Opaque run token for a staff journey or the anonymous resident entry

Operações
O objecto
{
  "audience": "platform",
  "locale": "pt-MZ",
  "generated_at": "2026-11-19T09:30:00Z",
  "steps": [
    {
      "id": "customer_import",
      "journey_id": "utility_real",
      "title": "Fuga na Rua 3",
      "line": "line",
      "state": "todo",
      "owner": "you",
      "action": {
        "id": "utility.real.customer_import",
        "label": "label",
        "route": "/platform/settings/branding"
      },
      "help": {
        "article_id": "getting-started/import-customers"
      },
      "blocked_reason": {
        "code": "review_pending",
        "message": "Leitura confirmada no local."
      },
      "wait_line": "A revisão costuma demorar cerca de 2 dias."
    }
  ],
  "doors": [
    {
      "id": "resident.link-existing-account",
      "title": "Fuga na Rua 3",
      "line": "line",
      "help": {
        "article_id": "residents/link-resident-account"
      }
    }
  ],
  "actions": [
    {
      "id": "resident.link-existing-account",
      "title": "Fuga na Rua 3",
      "line": "line",
      "help": {
        "article_id": "residents/link-resident-account"
      }
    }
  ],
  "run_token": "run token"
}

Obter os próximos passos antes de entrar

Registos

GET /next-steps

Returns the resident entry before sign-in: exactly two doors (link an existing account, request a new connection) and the public utility lookup and request-status actions, each with localized text and a help article ID, plus a signed timing token that holds no user, contact, account, tenant, IP or device identifier. Nothing here is a checklist step; a journey starts only when the resident picks a door.

Parâmetros

audiencestring · consulta · obrigatório

Only resident is supported

um de resident

Devolve

200 Resident entry

Mostrar atributos
audiencestring · obrigatório

um de platform, business, consumer, resident

localestring · obrigatório

um de pt-MZ, en-US

generated_atstring (date-time) · obrigatório
stepsarray of NextStep · obrigatório
Mostrar atributos filhos
idstring · obrigatório
journey_idstring · obrigatório
titlestring · obrigatório
linestring · obrigatório
statestring · obrigatório

um de todo, blocked

ownerstring · obrigatório

um de you, platform_review, team_member, utility_owner

actionobject · opcional
Mostrar atributos filhos
idstring · obrigatório

Portable destination intent each client maps to its own screen

labelstring · opcional

Localized action label

routestring · opcional

In-app route on the platform dashboard (platform setup only)

helpobject · obrigatório
Mostrar atributos filhos
article_idstring · obrigatório

Help registry category/slug

blocked_reasonobject · obrigatório · anulável
Mostrar atributos filhos
codestring · opcional
messagestring · opcional
wait_linestring · opcional

Optional, localized like line. On the utility's review step (documents) until approval: how long the platform's review usually takes. Present only when the server has a figure: the median of past decided reviews once there are at least 3, else the configured onboarding.review_wait (default 0, meaning absent).

doorsarray of NextStepChoice · opcional

The two resident entry doors (public entry only)

Mostrar atributos filhos
idstring · obrigatório
titlestring · obrigatório
linestring · obrigatório
helpobject · obrigatório
Mostrar atributos filhos
article_idstring · obrigatório
actionsarray of NextStepChoice · opcional

Public utility lookup and request-status actions (public entry only)

Mostrar atributos filhos
idstring · obrigatório
titlestring · obrigatório
linestring · obrigatório
helpobject · obrigatório
Mostrar atributos filhos
article_idstring · obrigatório
run_tokenstring · opcional

Opaque run token for a staff journey or the anonymous resident entry

Erros 400

curl -X GET "$PUBLIC_API/next-steps"
Resposta 200
{
  "audience": "platform",
  "locale": "pt-MZ",
  "generated_at": "2026-11-19T09:30:00Z",
  "steps": [
    {
      "id": "customer_import",
      "journey_id": "utility_real",
      "title": "Fuga na Rua 3",
      "line": "line",
      "state": "todo",
      "owner": "you",
      "action": {
        "id": "utility.real.customer_import",
        "label": "label",
        "route": "/platform/settings/branding"
      },
      "help": {
        "article_id": "getting-started/import-customers"
      },
      "blocked_reason": {
        "code": "review_pending",
        "message": "Leitura confirmada no local."
      },
      "wait_line": "A revisão costuma demorar cerca de 2 dias."
    }
  ],
  "doors": [
    {
      "id": "resident.link-existing-account",
      "title": "Fuga na Rua 3",
      "line": "line",
      "help": {
        "article_id": "residents/link-resident-account"
      }
    }
  ],
  "actions": [
    {
      "id": "resident.link-existing-account",
      "title": "Fuga na Rua 3",
      "line": "line",
      "help": {
        "article_id": "residents/link-resident-account"
      }
    }
  ],
  "run_token": "run token"
}