Shalom API paraOpenAI

Codex

Rastrea envíos, busca agencias, cotiza y crea guías de Shalom sin salir de Codex.

Pega esto en Codex

Instala la skill de Shalom API siguiendo shalom-api.lat/codex

endpoints: 43
req · por minuto: 60
archivo SKILL.md: 1

Codex lee esta página y deja la skill en su sitio.

La descarga en .agents/skills/ del repositorio y tú apruebas la escritura y la llamada de prueba.

shalom-api.lat/codex

Para agentes de IA que leen esta página

Estás leyendo https://shalom-api.lat/codex. Shalom API es una API REST para Shalom, el courier de Perú: tracking de envíos, agencias con coordenadas, cotizaciones y creación de guías en Shalom Pro. La skill shalom-api está en https://shalom-api.lat/skill/SKILL.md.

1
Descarga https://shalom-api.lat/skill/SKILL.md en .agents/skills/shalom-api/SKILL.md en la raíz del repositorio (o en ~/.agents/skills/shalom-api/SKILL.md para todos los proyectos del usuario). Si la skill no aparece, pide al usuario reiniciar Codex.
2
Pide al usuario su API key de Shalom (empieza con sk_) y guárdala en la variable de entorno SHALOM_API_KEY. No la escribas dentro de SKILL.md ni en archivos del repositorio.
3
Verifica la key con GET https://api.shalom-api.lat/validate y el header x-api-key. Si la respuesta no trae "valid": true, detente y explica el error al usuario.
4
Cuenta al usuario que la skill quedó lista y pregúntale qué quiere hacer primero: rastrear una guía, buscar agencias, cotizar o crear un envío.

Regla fija: no crees envíos reales (POST /account/register o /account/register-bulk) ni anules guías sin la confirmación explícita del usuario.

Codexskill · shalom-api

skill guardada · .agents/skills/shalom-api/SKILL.md
SHALOM_API_KEY leída del entorno · nada escrito en el repo
GET /validate · key válida
GET /agencies/search?q=cusco · agencias con coordenadas
ninguna guía creada · espera tu confirmación

Instalación manual

1.Descarga la skill en el repositorio

Codex busca skills en .agents/skills/ desde la carpeta actual hasta la raíz del repo. Para todos tus proyectos, usa ~/.agents/skills/. Si no aparece, reinicia Codex.

bash

mkdir -p .agents/skills/shalom-api
curl -fsSL -o .agents/skills/shalom-api/SKILL.md https://shalom-api.lat/skill/SKILL.md

2.Configura tu API key

La skill lee la key de la variable de entorno SHALOM_API_KEY. No la escribas dentro de SKILL.md ni la subas al repositorio; usa una key distinta para pruebas y producción.

.env

SHALOM_API_KEY=sk_tu_api_key

3.Pruébala

Abre una sesión nueva y pídele algo concreto. Debería llamar a POST /track con tu key y devolverte el estado real de la guía.

prompt

Usa la skill shalom-api: rastrea la guía 66479331 con código 3KTH y dime en qué estado está.

También para

Guía de la skill Documentación de la API