Aller au contenu
Livstick Développeurs

Get legacy message details

Méthode POST {API_BASE}/v2.1/client/{key}/{crid}/details

Return the V2 details envelope for a CRID with a message. messageUrl keeps its historical domain/{urid} format; new URL fields are complete HTTPS URLs.

Autorisation

Scope requis client_v2

The API key is intentionally kept in the path for V2 compatibility: /v2.1/client/{key}/{crid}/... or /v2.1/user/{key}/{crid}/.... Client routes require the client_v2 scope. User routes require the user_v2 scope. Unknown, expired, revoked, malformed, or wrong-scope keys return the legacy JSON error envelope.

Paramètres

Nom Emplacement Type Requis Contraintes Description
key Chemin string Requis API key kept in the URL for V2 compatibility. Requires client_v2 or user_v2 depending on the route.
crid Chemin string Requis Client reference ID, usually an order or campaign reference.

Réponses

200 application/json Schéma DetailsResponse Schéma LegacyError

Message details, or shipped container without message.

400 application/json Schéma LegacyError

Invalid key, CRID, payload, message state or business precondition.

json 400
{
  "status": 1,
  "error": "key_invalid"
}

keyInvalid

json 400
{
  "status": 1,
  "error": "key_invalid"
}

cridUnknown

json 400
{
  "status": 1,
  "error": "crid_unknown"
}

dataInvalid

json 400
{
  "status": 1,
  "error": "data_invalid"
}

noMessage

json 400
{
  "status": 1,
  "error": "no_message_for_this_crid"
}

messageMissing

json 400
{
  "status": 1,
  "error": "message_missing"
}

noLanguage

json 400
{
  "status": 1,
  "error": "no_language_found"
}

noPdfTemplate

json 400
{
  "status": 1,
  "error": "no_pdf_template"
}

webhookNotFound

json 400
{
  "status": 1,
  "error": "webhook_not_found"
}

403 application/json Schéma LegacyError

Key is authenticated but scope or platform constraints are invalid.

json 403
{
  "status": 1,
  "error": "forbidden"
}

forbidden

json 403
{
  "status": 1,
  "error": "forbidden"
}

invalidPlatformConstraint

json 403
{
  "status": 1,
  "error": "key_invalid"
}