Saltar al contenido
AchaduDevelopers
Developers/API/segment_get
Segmentos

Ver segmento

Devuelve un segmento de la operación.

GET/segments/{id}segments:read
COMPORTAMIENTO

La lectura busca el identificador dentro de la cuenta vinculada a la clave y devuelve 404 cuando no pertenece a la operación.

EFECTO

No cambia los recursos ni activa la publicación.

REPETICIÓN

Es seguro repetir la operación. En 429 o 5xx, use retroceso exponencial con fluctuación.

Solicitar

idstring · pathIdentificador de recursos.minLength 2 · maxLength 100obligatorio
AuthorizationBearer ach_live_...
Acceptapplication/json
Alcancesegments:read

Ejemplo ejecutable

curl
curl 'https://achadu.com/api/v1/segments/resource_id' \
  -H 'Authorization: Bearer ach_live_...' \
  -H 'Accept: application/json'

Respuesta y errores

Cada respuesta incluye request_id. Las listas añaden paginación; Los recursos mutables devuelven el estado persistente después de la operación.

200 application/json
{
  "data": {
    "id": "seg_01J...",
    "name": "Home and kitchen",
    "slug": "home-and-kitchen",
    "distribution": "balanced",
    "created_at": "2026-08-31T18:20:00.000Z"
  },
  "request_id": "req_01J..."
}
200Operación completada.
400Parámetro, cuerpo o transición no válidos.
401Clave faltante, inválida, caducada o revocada.
402El plan de cuenta no libera esta interfaz.
403A chave precisa do escopo segments:read.
404La característica no existe en esta cuenta.
409El estado actual impide esta operación.
413El cuerpo JSON supera los 128 KB.
429Se ha superado la ventana de 120 solicitudes por minuto.