Integra Arko sin SDK: curl, fetch y axios

Arko no exige un SDK propio para integrarse: la API es JSON sobre HTTP estándar, así que cualquier cliente que sepa hacer una petición —curl en una terminal, fetch en el navegador o en un runtime de servidor, axios en un proyecto que ya lo trae— es suficiente para construir una integración completa.

La misma llamada, tres formas

Autenticar, mandar el cuerpo y leer la respuesta funciona igual en los tres casos: una cabecera de autorización con tu Bearer token, un tipo de contenido JSON en cualquier POST, PUT o PATCH, y el envelope de respuesta —success y data, o success en false y message— que interpretas del mismo modo sin importar qué cliente HTTP usaste para llegar ahí.

curl para probar antes de programar nada

Antes de escribir una línea de integración, vale la pena confirmar el comportamiento de un endpoint con curl: es la forma más rápida de descartar un error de tu código frente a uno de la petición misma. Una vez que la llamada por curl responde lo que esperabas, trasladarla a fetch o axios es mecánico.

El caso particular del streaming

Consumir NDJSON con fetch requiere leer el cuerpo como stream y cortar por saltos de línea vos mismo —no hay un parser de JSON que lo haga por defecto. Con axios, la opción de tipo de respuesta en modo stream te da acceso al mismo flujo de bytes crudo. Con curl, cada línea llega a la terminal a medida que se genera, útil para verificar visualmente que el streaming funciona antes de programar el parseo.

Cuándo sí conviene una capa propia

Si tu equipo integra varios endpoints de Arko desde distintos puntos de tu backend, construir una capa delgada propia —una función que agrega el Bearer, maneja el envelope y centraliza el manejo del código de error— ahorra repetir esa lógica en cada llamada. No es un SDK, es simplemente no duplicar diez veces el mismo manejo de errores.