Llamadas
Llama a una API pública desde la página que ya tienes abierta.
Una petición API desde esta página pide datos a este sitio y muestra la respuesta. El laboratorio de API explica la petición en sí. El laboratorio de Sources pausa un archivo de práctica y lo recorre paso a paso. Esta página es el siguiente movimiento: cambia ese tipo de archivo para que pida información a este sitio y luego lee la respuesta. El laboratorio de Webhooks es la otra dirección, un servicio que te llama a ti. Las dos rutas son GET /api/data-centers y GET /api/collect. Ninguna escritura forma parte del ejercicio.
Entender el laboratorioCómo usarlo y por qué querrías hacerlo
Por qué querrías hacerlo
Dos GET del mismo origen, la búsqueda de centros de datos y la lista de collect, corren solo después de que el JSON guardado ponga callApis en true y ambas rutas pasen la guarda. Cualquier otra cosa se rechaza.
Cómo usarlo
- Abre el documento de dos peticiones en la página.
- Cada llamada es una ruta relativa, no un host externo.
- Una ruta que no sea esos dos GET se rechaza.
- La red se queda en silencio hasta que callApis es true.
Los atajos son para Chrome en Mac y en Windows. En un portátil Mac, las teclas F suelen necesitar también Fn, salvo que el teclado las use como teclas de función estándar. Los atajos con Command no necesitan Fn. Pasa el cursor por un botón de la barra para confirmar el atajo en el Chrome que tienes abierto.
fetch desde Console
Haz clic en la página una vez para que el atajo llegue al navegador y luego abre Console.
MacCommand + Option + JWindowsControl + Shift + JSources es el otro panel que vas a usar. Ábrelo con Command + Option + I en Mac, o F12 o Control + Shift + I en Windows, y luego haz clic en Sources. Escape muestra Console como un cajón bajo Sources, que es la disposición útil cuando estás en pausa. Command + Shift + P en Mac, o Control + Shift + P en Windows, abre el Command Menu si un panel está oculto. Escribe Show Console o Show Sources.
La consola se ejecuta en esta página. Un fetch desde aquí es lo mismo que un fetch que hiciera la página. Pega esto y pulsa Enter. El top-level await funciona en la consola de Chrome, así que la línea espera la respuesta:
const response = await fetch("/api/collect", { method: "GET", cache: "no-store" })
response.status200 significa que la ruta respondió. El cuerpo es un paso posterior. Deja el método en GET.
La misma llamada, en pausa y sin pausa
Sin pausa, el event loop de la página está en marcha. La consola envía la petición y la promesa se resuelve sola. Puedes leer response.status en la línea siguiente.
En pausa, Chrome ha detenido el JavaScript de la página en un breakpoint. La consola evalúa entonces en el frame del call stack seleccionado, así que puedes ver variables locales como path. Un fetch que empieces desde ese prompt puede salir del navegador, pero la página no puede ejecutar la continuación que lee el cuerpo hasta que hagas resume. Si un await se queda ahí y no termina, haz resume y vuelve a mirar.
MacF8 or Command + \\WindowsF8 or Control + \\Eso reanuda hasta el siguiente breakpoint. Command + F8 en Mac, o Control + F8 en Windows, desactiva los breakpoints cuando quieres que el resto del clic termine.
Usa la consola sin pausa cuando quieras la respuesta al momento. Usa la consola en pausa cuando quieras llamar desde dentro de una función e inspeccionar los locales alrededor de esa llamada.
Snippets de DevTools
Un snippet es un script que Chrome guarda en DevTools, no en este sitio. Se ejecuta en la página, así que puede ver bbpDebugCalls y puede hacer fetch a este origen. Abre el Command Menu y ejecuta Create new snippet, o abre Sources y elige Snippets en el panel izquierdo.
Con el snippet enfocado, ejecútalo.
MacCommand + EnterWindowsControl + EnterCommand + P en Mac, o Control + P en Windows, y luego un nombre que empiece por !, también ejecuta un snippet guardado. Un snippet es el sitio adecuado para una llamada que quieras repetir. Sigue siendo solo esta página: no puede leer otro origen que no lo haya permitido, y no debería hacer POST.
Local Overrides
Una edición en vivo dura hasta la recarga. Un override dura más, porque Chrome sirve un archivo desde una carpeta que elegiste en lugar de la red. En Sources, abre Overrides y elige Select folder for overrides. Chrome pide permiso para esa carpeta. Después, un guardado en un archivo de este origen escribe el override.
Aquí importan tres tipos de override:
- Un archivo JavaScript. Abre /debug/api-calls.js, cambia callApis a true, y guarda. Recarga. El botón ejecuta entonces la copia de tu carpeta. Borra el override, o límpialo desde el panel Overrides, cuando quieras de nuevo el archivo del servidor.
- Contenido de la respuesta. En Network, haz clic derecho en un GET terminado a este origen y elige Override content. Chrome abre el cuerpo. Puedes cambiar una copia del JSON para ver cómo un lector maneja otro payload. Quítalo antes de decidir qué devuelve la ruta en vivo.
- Cabeceras de la respuesta. Haz clic derecho en ese mismo GET y elige Override headers. Puedes añadir una cabecera en una respuesta que esta página ya podía leer, luego recargar y mirar response.headers. Eso es una copia local.
Un override no hace legible una respuesta cross-origin bloqueada, y no concede una cookie ni un token que no tengas. No inventes una cabecera Access-Control-Allow-Origin para llegar a la API de otra persona.
Edita una función en vivo en Sources
Abre el archivo de práctica. Command + O o Command + P en Mac. Control + O o Control + P en Windows. Escribe api-calls. Está bajo este host, en debug. Salta a la función con Command + Shift + O en Mac, o Control + Shift + O en Windows, y escribe readPracticeCalls.
El archivo va sin minificar a propósito, también en producción, así que los nombres y los saltos de línea que ves son los de public/debug/api-calls.js. Cambia el cuerpo de readPracticeCalls. Guarda.
MacCommand + SWindowsControl + SChrome parchea esa función en esta pestaña. El siguiente clic usa el cuerpo nuevo. Un guardado que solo cambia una línea fuera de la función no vuelve a ejecutar el script. Pon la edición dentro de readPracticeCalls. Recargar tira el parche, salvo que Local Overrides esté conservando el archivo.
Copy as fetch y Copy as cURL
Cuando una llamada ha terminado, abre Network y haz clic en la petición. Haz clic derecho y elige Copy, luego Copy as fetch. Pégalo en la consola sin pausa. Es un fetch con la URL y las cabeceras que Chrome registró. Edita la query, por ejemplo cambia Dallas por otra ciudad en /api/data-centers, y ejecútalo otra vez. Mantén el método GET.
Copy as cURL (bash) en Mac, y Copy as cURL (cmd) o Copy as PowerShell en Windows, construye un comando de shell para la misma petición. Replay XHR, en el mismo menú de clic derecho, vuelve a enviar la petición desde el navegador sin pegar nada.
Chrome incluye la cabecera Cookie en esa copia cuando el navegador envió una. bbp.visitor es HttpOnly, así que el JavaScript de la página no puede leerla, pero una línea cURL copiada puede contenerla igual. Borra Cookie y Authorization antes de guardar o compartir el comando. Reproducir una cookie copiada es reproducir una credencial.
Estado, cabeceras y timing
El objeto response no es el JSON. Lee el estado antes de interpretar el cuerpo:
response.status
response.ok
response.headers.get("content-type")
await response.json()headers es una lista, no un objeto plano. get lee un nombre. La ruta de centros de datos añade X-Upstream-Cache y, cuando llamó a Wikidata, una cabecera Server-Timing. El JSON de la ruta collect tiene store, driver, y records. El archivo de práctica informa del conteo de records y descarta las filas.
En Network, abre la petición y luego Timing. Queueing, request sent, waiting for server response y content download son las partes de ese intercambio. El archivo de práctica también cronometra el fetch con performance.now, que es la espera dentro de la página, no el desglose de la pestaña Timing. Resource Timing, performance.getEntriesByType("resource"), es la misma familia de números para cada petición que hizo este documento.
Por qué CORS, las cookies y los tokens detienen un script
Un script puede pedir cualquier URL. El navegador decide qué puede leer de vuelta el script. Las llamadas same-origin de este host son legibles. Una llamada a otro origen es legible solo si ese servidor envía Access-Control-Allow-Origin para esta página. Si no lo hace, la consola muestra un error de CORS y la promesa se rechaza. Eso es el navegador aplicando la cabecera del otro sitio, no un acertijo que haya que rodear.
Las cookies siguen una segunda regla. Un fetch same-origin envía las cookies de este sitio, incluidas las HttpOnly, sin que JavaScript las lea. Un fetch cross-origin omite las cookies salvo que pongas credentials: "include" y el otro servidor permita de forma explícita este origen y las credenciales. Una cabecera Authorization no se añade sola. Poner un token en una cabecera provoca un preflight, y el otro servidor tiene que permitir esa cabecera. Un token en localStorage de este origen no es visible para otro origen.
La Content-Security-Policy de este sitio también limita connect-src. La consola de esta página puede llamar a este origen. No es un cliente general para el resto de la web. La búsqueda de centros de datos llega a Wikidata desde el servidor, por eso el script de práctica llama a /api/data-centers en lugar del servicio de consulta.
Práctica: edita el archivo para que llame
El archivo es /debug/api-calls.js. La función es readPracticeCalls. Ya contiene las dos llamadas GET. callApis es false, así que hace return antes de cualquiera de las dos. El botón dibuja lo que devuelva la función.
/api/data-centers?country=US&city=Dallas&name=DataBank es la misma búsqueda que el laboratorio de API. GET /api/collect es el estado que consulta el Laboratorio de recolección: dónde viven las filas, qué driver está abierto y cuántas filas tiene el id de visitante de este navegador. El archivo de práctica no hace POST, así que no guarda un beacon.
Solo esta pestaña
Ejecutar las llamadas de práctica
El botón llama a readPracticeCalls y dibuja el valor de retorno. Hasta que edites el archivo, ese valor dice que las llamadas están apagadas. Después de guardar callApis = true, el mismo botón ejecuta dos peticiones GET y muestra su estado.
Editar y ejecutar abre una copia JSON guardada en este navegador. Esa ventana no cambia el archivo del servidor /debug/api-calls.js. Los pasos debajo del panel son el camino avanzado, en DevTools.
Aún no hay ninguna ejecución.
Avanzado: edita el archivo en DevTools
Estos pasos cambian /debug/api-calls.js en esta pestaña, y con Local Overrides si quieres que la edición sobreviva a la recarga. Editar y ejecutar es otro camino. Guarda una copia en este navegador y deja intacto el archivo del servidor.
- Espera a que el botón diga Ejecutar las llamadas de práctica. Eso significa que el archivo de práctica ha cargado. Haz clic una vez. El panel debería decir que callApis es false.
- Abre /debug/api-calls.js desde Sources. Command + P en Mac, Control + P en Windows. Confirma que los saltos de línea coinciden con el archivo, no con un bundle de una sola línea.
- Salta a readPracticeCalls. Cambia const callApis = false por const callApis = true.
- Guarda con Command + S en Mac o Control + S en Windows. Para una copia que sobreviva a la recarga, activa primero Local Overrides, luego guarda y luego recarga.
- Haz clic otra vez en Ejecutar las llamadas de práctica. El panel debería mostrar un estado y un tiempo para cada GET. Basta un conteo de filas de centros de datos y un conteo de records de collect. El nombre del primer centro es una etiqueta, no algo que tengas que hacer coincidir.
- Opcional. Pon un breakpoint de línea en el fetch dentro de readGet, haz clic en el botón y prueba fetch(path) desde la consola en pausa. Resume con F8 para que el botón pueda dibujar el resultado.
- Opcional. En Network, haz clic derecho en el GET de centros de datos, Copy as fetch, cambia la ciudad y ejecuta ese pegado desde la consola sin pausa. Déjalo en GET.
Qué puedes llamar
Usa esta lección en tu propio navegador y en las rutas GET públicas de este sitio, o en una API que sea de verdad pública y permita la llamada. Estas páginas son una lección. No son permiso para probar una cuenta, una cookie de sesión o un token que no sea tuyo, ni permiso para ignorar las condiciones de otro sitio, sus cabeceras CORS o sus límites de ritmo.
Basta una búsqueda de centros de datos y una lectura del estado de collect. La búsqueda se cachea aquí y el origen es Wikidata, que pide a quien llama que no martillee el servicio de consulta. No la pongas en bucle. No apuntes la función de práctica a un POST, incluido POST /api/collect. El consentimiento sigue decidiendo si se guarda un beacon. Este botón no envía ninguno.
El laboratorio de Sources es la mitad de pausar y avanzar de este recorrido. Su archivo de práctica no llama a fetch. Este sí, después de que lo edites.
RecorridoCómo lo hicimosMostrarOcultar
El ajuste de proveedor de ejemplo está marcado abajo. Los números de eVar y de event son ejemplos. Este laboratorio no llama a Adobe.
El laboratorio de llamadas ejecuta dos GET del mismo origen, la búsqueda de centros de datos y la lista de collect, solo después de que el JSON guardado ponga callApis en true y ambas rutas pasen la guarda. El laboratorio no llama a Adobe.
Interpretar un documento de dos peticiones
parsePracticeConfig acepta callApis y un array requests de longitud 2. Cada petición debe ser GET, y las dos URL deben ser la ruta de centros de datos y la ruta de collect, una vez cada una.
Armar una ruta relativa
practiceRequestPath copia country, city y name en la ruta de centros de datos. La ruta de collect rechaza cualquier query. El resultado pasa por la guarda.
Rechazar lo que no sean esos dos GET
guardPracticePath permite solo una ruta del mismo origen para esas dos rutas. Un esquema, un host, un hash o una doble barra devuelven null, y el ejecutor lanza un error.
Saltar la red hasta que callApis sea true
executePracticeConfig devuelve called false y la nota de apagado cuando callApis es false. Cuando es true, los dos GET corren juntos y la página muestra estado, tiempo y un resumen corto. Este componente no llama a trackLabEvent.
Del código
Solo los filtros de centros de datos y una query vacía de collect se vuelven una ruta.
export function practiceRequestPath(request: PracticeRequest): string | null {
if (request.method !== "GET") return null
if (request.url !== DATA_CENTERS_PATH && request.url !== COLLECT_PATH) return null
const params = new URLSearchParams()
if (request.url === DATA_CENTERS_PATH) {
for (const key of CENTER_KEYS) {
const value = request.params[key]
if (value === undefined) continue
if (typeof value !== "string" || !value) return null
params.set(key, value)
}
for (const key of Object.keys(request.params)) {
if (key !== "country" && key !== "city" && key !== "name") return null
}
} else if (Object.keys(request.params).length > 0) {
return null
}callApis false vuelve antes del fetch. Si no, los dos GET corren juntos.
export async function executePracticeConfig(
config: PracticeConfig,
get: (path: string) => Promise<PracticeGetReport>,
offNote: string
): Promise<PracticeResult> {
if (!config.callApis) return { called: false, note: offNote }
const centersReq = config.requests.find((item) => item.url === DATA_CENTERS_PATH)
const collectReq = config.requests.find((item) => item.url === COLLECT_PATH)
const centersPath = centersReq ? practiceRequestPath(centersReq) : null
const collectPath = collectReq ? practiceRequestPath(collectReq) : null
if (!centersPath || !collectPath) throw new Error("blocked")
const [centers, collect] = await Promise.all([get(centersPath), get(collectPath)])
return { called: true, centers: summarizeCenters(centers), collect: summarizeCollect(collect) }
}Google y Adobe
Este laboratorio no encola un evento propio. El bloque de Google muestra un ejemplo de cómo rastrearías la interacción. Adobe también es un ejemplo.
Este laboratorio no encola un evento de analítica propio. Después de Aceptar, el sitio sigue encolando virtual_page_view de la página, con page_path y page_title. Los clics dentro de una región data-track-ignore no se registran. El push de abajo es un ejemplo, no una llamada de esta página. Este sitio no llama a gtag('set') ni a Adobe.
Solo ejemplo. Esta página no hace push de este objeto.
// Example only. This lab does not queue this event.
dataLayer.push({
event: "practice_get_example",
path: "/api/data-centers",
called: false,
})Implementación de ejemplo. Este sitio no llama a Adobe. eVar53, prop53 y event53 son números de variable de ejemplo. En Launch, un elemento de datos lee el valor y una regla lo envía cuando el valor cambia. En el report suite, habilita eVar53 con asignación Most Recent y haz que expire en el hit. Una processing rule no hace falta si el elemento de datos se mapea directo a esa eVar.
Payload de alloy de ejemplo. _example es un esquema de relleno, no un inquilino real.
alloy("sendEvent", {
xdm: {
eventType: "web.webinteraction.linkClicks",
_example: {
practicePath: "/api/data-centers",
},
},
})Hit de ejemplo. eVar53 tiene alcance de hit en este ejemplo. prop53 muere en el mismo hit.
s.eVar53 = "/api/data-centers"
s.prop53 = "/api/data-centers"
s.events = "event53"
s.linkTrackVars = "eVar53,prop53,events"
s.linkTrackEvents = "event53"
s.tl(true, "o", "practice_get_example")Traducción
Cada campo del laboratorio, el nombre en GA4 y la variable de Adobe de ejemplo. El alcance es la parte que suele perderse en la traducción.
callApis
GA4. No se envía. false se salta los dos fetch.
Adobe. eVar53 de ejemplo, expira en el hit.
Alcance. Hit. Es un interruptor de esta ejecución, no una propiedad de usuario.
Ruta
GA4. No se envía. La ruta guardada es /api/data-centers o /api/collect.
Adobe. prop53 de ejemplo en el hit.
Alcance. Hit. La ruta es la petición, no una propiedad de la visita.
Estado
GA4. No se envía. El resumen muestra el estado HTTP de cada GET.
Adobe. eVar53 de ejemplo si enviaras el estado. Este laboratorio no lo hace.
Alcance. Un campo de esta respuesta. No es un evento.
Filtro
GA4. No se envía. country, city y name van en la query de centros de datos.
Adobe. prop53 de ejemplo. No se envía.
Alcance. Hit, si rastrearas el JSON guardado. No es una propiedad de usuario.
Recomendado a continuación
Por qué estas propuestasLeyendo las transiciones de recorrido…