PT EN

Pedidos de serviço

URL base: $PUBLIC_API

O objecto

idstring · obrigatório
statusstring · obrigatório

um de submitted, accepted, visit_scheduled, quoted, payment_pending, scheduled, completed, declined, withdrawn

pricedboolean · obrigatório
estimate_min_centsinteger (int64) · opcional
estimate_max_centsinteger (int64) · opcional
currencystring · opcional
created_atstring (date-time) · obrigatório
updated_atstring (date-time) · obrigatório
O objecto
{
  "id": "pub_2xPGwrxs6NLE2NvSIXby6fdkg31",
  "status": "submitted",
  "priced": true,
  "estimate_min_cents": 1,
  "estimate_max_cents": 1,
  "currency": "MZN",
  "created_at": "2026-11-19T09:30:00Z",
  "updated_at": "2026-11-19T09:30:00Z"
}

Criar um pedido de serviço

Registos

POST /service-requests

Request a new connection with a verified phone, without an account

Verifies the phone code from POST $AUTH_API/phone-codes, finds or creates the person's consumer identity (no password) and files the request with the utility. The answer shows only the request's progress, never personal data.

Corpo application/json

tenant_idstring · obrigatório
phonestring · obrigatório
otp_codestring · obrigatório
full_namestring · opcional
addressstring · opcional

Required unless plus_code is given

plus_codestring · opcional
localitystring · opcional
landmarkstring · opcional
connection_typestring · opcional

um de residential, commercial, industrial, institutional, government

challenge_tokenstring · opcional

Bot-challenge token when security.challenge is enabled (anonymous callers). Only UI requests (browser headers, the dashboard, or X-Client mobile or desktop) are challenged; API requests never are.

Devolve

201 Request filed

Mostrar atributos
idstring · obrigatório
statusstring · obrigatório

um de submitted, accepted, visit_scheduled, quoted, payment_pending, scheduled, completed, declined, withdrawn

pricedboolean · obrigatório
estimate_min_centsinteger (int64) · opcional
estimate_max_centsinteger (int64) · opcional
currencystring · opcional
created_atstring (date-time) · obrigatório
updated_atstring (date-time) · obrigatório

Erros 400 · 403 · 409 · 429 · 503

curl -X POST "$PUBLIC_API/service-requests" \
  -H "Content-Type: application/json" \
  -d '{
  "tenant_id": "ten_2ugFXIC316WXzGu1HGal90AxTA6",
  "phone": "+258841234567",
  "otp_code": "OTP-2026-000142",
  "full_name": "Ana Matsinhe",
  "address": "Av. Julius Nyerere 1420, Maputo",
  "plus_code": "PLU-2026-000142",
  "locality": "locality",
  "landmark": "landmark",
  "connection_type": "residential",
  "challenge_token": "challenge token"
}'
Resposta 201
{
  "id": "pub_2xPGwrxs6NLE2NvSIXby6fdkg31",
  "status": "submitted",
  "priced": true,
  "estimate_min_cents": 1,
  "estimate_max_cents": 1,
  "currency": "MZN",
  "created_at": "2026-11-19T09:30:00Z",
  "updated_at": "2026-11-19T09:30:00Z"
}

Acompanhar um pedido de serviço

Registos

GET /service-requests/{id}

Shows status and estimate only; no phone, name, address or decline reason.

Parâmetros

idstring · caminho · obrigatório

Identifier returned when the service request was created without an account; anyone holding it sees only the status, timestamps and, once priced, the estimate range, never the requester's contact details or address.

Devolve

200 Request progress

Mostrar atributos
idstring · obrigatório
statusstring · obrigatório

um de submitted, accepted, visit_scheduled, quoted, payment_pending, scheduled, completed, declined, withdrawn

pricedboolean · obrigatório
estimate_min_centsinteger (int64) · opcional
estimate_max_centsinteger (int64) · opcional
currencystring · opcional
created_atstring (date-time) · obrigatório
updated_atstring (date-time) · obrigatório

Erros 404

curl -X GET "$PUBLIC_API/service-requests/{id}"
Resposta 200
{
  "id": "pub_2xPGwrxs6NLE2NvSIXby6fdkg31",
  "status": "submitted",
  "priced": true,
  "estimate_min_cents": 1,
  "estimate_max_cents": 1,
  "currency": "MZN",
  "created_at": "2026-11-19T09:30:00Z",
  "updated_at": "2026-11-19T09:30:00Z"
}