Pedir una revisión de precio en vivo

POSThttps://pricto.dev/v1/live-checks

Planificado. Todavía no existe: hoy responde 501 not_implemented.

Captures the offer right now instead of returning the last scheduled capture. Asynchronous: returns a job that completes in seconds to minutes. Not available yet (returns 501).

Créditos	MCP
10 per offer refreshed	—

Parámetros#

Sin parámetros.

Cuerpo#

Campo	Tipo	Descripción
`offer_ids` requerido	`string[]`

Respuesta#

202 Job accepted.

Campo	Tipo	Descripción
`data`	`Job`
`data.id` requerido	`string`
`data.status` requerido	`string`	Valores / values: `queued`, `running`, `succeeded`, `failed`.
`data.created_at`	`string (date-time)`
`data.finished_at`	`string (date-time) \| null`
`data.rows`	`integer \| null`
`data.files`	`object[]`
`data.files[].url`	`string (uri)`
`data.files[].bytes`	`integer`
`data.files[].expires_at`	`string (date-time)`
`data.error`	`object`
`meta`	`Meta`

meta trae el costo, la fuente para citar, el idioma, la moneda y los avisos (ver Convenciones).

Errores#

not_implemented

Request a live price check

POSThttps://pricto.dev/v1/live-checks

Planned. Not available yet: today it answers 501 not_implemented.

Captures the offer right now instead of returning the last scheduled capture. Asynchronous: returns a job that completes in seconds to minutes. Not available yet (returns 501).

Credits	MCP
10 per offer refreshed	—

Parameters#

No parameters.

Body#

Field	Type	Description
`offer_ids` required	`string[]`

Response#

202 Job accepted.

Field	Type	Description
`data`	`Job`
`data.id` required	`string`
`data.status` required	`string`	Valores / values: `queued`, `running`, `succeeded`, `failed`.
`data.created_at`	`string (date-time)`
`data.finished_at`	`string (date-time) \| null`
`data.rows`	`integer \| null`
`data.files`	`object[]`
`data.files[].url`	`string (uri)`
`data.files[].bytes`	`integer`
`data.files[].expires_at`	`string (date-time)`
`data.error`	`object`
`meta`	`Meta`

meta carries the cost, the source line to quote, the language, the currency and notices (see Conventions).

Errors#

not_implemented

Ejemplo#

curl -X POST "https://pricto.dev/v1/live-checks" \
  -H "Authorization: Bearer sk_test_sandbox" \
  -H "Content-Type: application/json" \
  -d '{"offer_ids":["ofr_01nuni"]}'

import requests

API_KEY = "sk_test_sandbox"

r = requests.post(
    "https://pricto.dev/v1/live-checks",
    json={
        "offer_ids": [
            "ofr_01nuni",
        ],
    },
    headers={"Authorization": f"Bearer {API_KEY}"},
)
print(r.status_code, r.json())

const API_KEY = "sk_test_sandbox";

const res = await fetch("https://pricto.dev/v1/live-checks", {
  method: "POST",
  headers: { Authorization: `Bearer ${API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    "offer_ids": [
      "ofr_01nuni"
    ]
  }),
});
console.log(res.status, await res.json());

501 · respuesta real de la sandbox

{
  "type": "https://pricto.dev/docs#not_implemented",
  "title": "Todavía no disponible",
  "status": 501,
  "code": "not_implemented",
  "detail": "Live checks está planificado y todavía no está disponible.",
  "hint": "Para volúmenes grandes usa /offers con format=csv y paginación.",
  "request_id": "req_12744e1aad8d4810840c",
  "docs_url": "https://pricto.dev/docs#not_implemented"
}

Example#

curl -X POST "https://pricto.dev/v1/live-checks" \
  -H "Authorization: Bearer sk_test_sandbox" \
  -H "Content-Type: application/json" \
  -d '{"offer_ids":["ofr_01nuni"]}'

import requests

API_KEY = "sk_test_sandbox"

r = requests.post(
    "https://pricto.dev/v1/live-checks",
    json={
        "offer_ids": [
            "ofr_01nuni",
        ],
    },
    headers={"Authorization": f"Bearer {API_KEY}"},
)
print(r.status_code, r.json())

const API_KEY = "sk_test_sandbox";

const res = await fetch("https://pricto.dev/v1/live-checks", {
  method: "POST",
  headers: { Authorization: `Bearer ${API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    "offer_ids": [
      "ofr_01nuni"
    ]
  }),
});
console.log(res.status, await res.json());

501 · real sandbox response

{
  "type": "https://pricto.dev/docs#not_implemented",
  "title": "Todavía no disponible",
  "status": 501,
  "code": "not_implemented",
  "detail": "Live checks está planificado y todavía no está disponible.",
  "hint": "Para volúmenes grandes usa /offers con format=csv y paginación.",
  "request_id": "req_12744e1aad8d4810840c",
  "docs_url": "https://pricto.dev/docs#not_implemented"
}