Abrir um convite
RegistosPOST /utility-invitations/open
Resolves the one-time token from the invitation landing page and records the invitation as opened. Returns the utility name, country, setup mode, masked owner contact and expiry so the page can be prefilled. Expired, revoked or used tokens return 410 without saying whether any account exists.
Corpo application/json
tokenOne-time token from the invitation link
Devolve
curl -X POST "$PUBLIC_API/utility-invitations/open" \
-H "Content-Type: application/json" \
-d '{
"token": "token"
}'
# Sem comando CLI equivalente; use cURL ou HTTP directo.
const res = await fetch("$PUBLIC_API/utility-invitations/open", {
method: "POST",
headers: {
"Content-Type": "application/json"
},
body: JSON.stringify({
"token": "token"
})
});
const data = await res.json();
import requests
res = requests.post(
"$PUBLIC_API/utility-invitations/open",
json={
"token": "token"
}
)
data = res.json()
body := strings.NewReader(`{
"token": "token"
}`)
req, _ := http.NewRequest("POST", "$PUBLIC_API/utility-invitations/open", body)
req.Header.Set("Content-Type", "application/json")
resp, err := http.DefaultClient.Do(req)
{
"utility_name": "Ana Matsinhe",
"country_code": "MZ",
"setup_mode": "invite",
"owner_contact_masked": "owner contact masked",
"contact_kind": "email",
"expires_at": "2026-11-19T09:30:00Z"
}