# Servicio de solicitudes y respuestas HTTP

Inspecciona solicitudes, prueba respuestas y depura integraciones.

Para generar cadenas e identificadores aleatorios, prueba [rand.hacks.run](https://rand.hacks.run/).

**Base URL**

https://200ok.hacks.run

**Salida**

Se devuelve texto sin formato de forma predeterminada. Usa `?json` para obtener JSON compacto o `?pretty` para JSON con formato. Los indicadores se activan por su presencia, independientemente de su valor. `?pretty` tiene prioridad sobre `?json`.

**Ejecutar localmente**

```sh
docker run --rm -p 3000:3000 ghcr.io/teplostanski/200ok:latest
```

[http://localhost:3000](http://localhost:3000/)

El límite predeterminado es de 64 niveles de objetos o arrays JSON. Para pruebas locales más profundas, configure JSON\_MAX\_DEPTH entre 1 y 512. Se mantiene el límite de 100 KiB para el cuerpo.

```sh
docker run --rm -e JSON_MAX_DEPTH=256 -p 3000:3000 ghcr.io/teplostanski/200ok:latest
```

## Status

### `/status/{code}`

[Referencia de códigos de estado HTTP](https://200ok.hacks.run/es/status-codes)

GET, POST, PUT, PATCH, DELETE

Devuelve el código de estado HTTP seleccionado y su frase descriptiva.

**Importante:** Los códigos `204`, `205` y `304` no tienen cuerpo de respuesta. Para `1xx`, el estado de la respuesta HTTP es `200`.

**Detalles**

#### Ejemplos de solicitudes

GET

```sh
curl https://200ok.hacks.run/status/200
```

#### Respuestas

##### 200 OK

El cuerpo de la respuesta contiene el código solicitado y su frase descriptiva, también para 1xx. Ejemplo: 200 OK.

Ejemplo · text/plain

```
200 OK
```

Ejemplo · application/json

```
{"code":200,"reason":"OK"}
```

Esquema · object

| Campo | Tipo | Descripción |
| --- | --- | --- |
| `code`obligatorio | `integer` | Valor de la cabecera. |
| `reason`obligatorio | `string` | Valor de la cabecera. |

Ejemplo · application/json

```
{
  "code": 200,
  "reason": "OK"
}
```

Esquema · object

| Campo | Tipo | Descripción |
| --- | --- | --- |
| `code`obligatorio | `integer` | Valor de la cabecera. |
| `reason`obligatorio | `string` | Valor de la cabecera. |

## IP

### [`/ip`](https://200ok.hacks.run/ip)

GET

La dirección IP del cliente (IPv4 o IPv6).

**Detalles**

#### Ejemplos de solicitudes

GET

```sh
curl https://200ok.hacks.run/ip
```

#### Respuestas

##### 200 OK

La dirección IP del cliente (IPv4 o IPv6).

Ejemplo · text/plain

```
192.0.2.1
```

Ejemplo · application/json

```
{"ip":"192.0.2.1"}
```

Esquema · object

| Campo | Tipo | Descripción |
| --- | --- | --- |
| `ip`obligatorio | `string` | La dirección IP del cliente (IPv4 o IPv6). |

Ejemplo · application/json

```
{
  "ip": "192.0.2.1"
}
```

Esquema · object

| Campo | Tipo | Descripción |
| --- | --- | --- |
| `ip`obligatorio | `string` | La dirección IP del cliente (IPv4 o IPv6). |

### [`/ip/v4`](https://200ok.hacks.run/ip/v4)

GET

La dirección IPv4 del cliente.

**Detalles**

#### Ejemplos de solicitudes

GET

```sh
curl https://200ok.hacks.run/ip/v4
```

#### Respuestas

##### 200 OK

La dirección de conexión del cliente. Este ejemplo usa una IP de documentación. Si la familia de direcciones no coincide con el endpoint, la respuesta es unknown en texto y null en JSON.

Ejemplo · text/plain

```
192.0.2.1
```

Ejemplo · application/json

```
{"ip":"192.0.2.1"}
```

Esquema · object

| Campo | Tipo | Descripción |
| --- | --- | --- |
| `ip`obligatorio | `string | null` | Dirección IP; null si la familia de direcciones no coincide. |

Ejemplo · application/json

```
{
  "ip": "192.0.2.1"
}
```

Esquema · object

| Campo | Tipo | Descripción |
| --- | --- | --- |
| `ip`obligatorio | `string | null` | Dirección IP; null si la familia de direcciones no coincide. |

### [`/ip/v6`](https://200ok.hacks.run/ip/v6)

GET

La dirección IPv6 del cliente.

**Detalles**

#### Ejemplos de solicitudes

GET

```sh
curl https://200ok.hacks.run/ip/v6
```

#### Respuestas

##### 200 OK

La dirección de conexión del cliente. Este ejemplo usa una IP de documentación. Si la familia de direcciones no coincide con el endpoint, la respuesta es unknown en texto y null en JSON.

Ejemplo · text/plain

```
2001:db8::1
```

Ejemplo · application/json

```
{"ip":"2001:db8::1"}
```

Esquema · object

| Campo | Tipo | Descripción |
| --- | --- | --- |
| `ip`obligatorio | `string | null` | Dirección IP; null si la familia de direcciones no coincide. |

Ejemplo · application/json

```
{
  "ip": "2001:db8::1"
}
```

Esquema · object

| Campo | Tipo | Descripción |
| --- | --- | --- |
| `ip`obligatorio | `string | null` | Dirección IP; null si la familia de direcciones no coincide. |

## Echo

### [`/echo`](https://200ok.hacks.run/echo)

GET, POST, PUT, PATCH, DELETE

Devuelve el método y el cuerpo de la solicitud. Acepta JSON, texto sin formato, formularios codificados en URL y datos binarios.

**Detalles**

#### Ejemplos de solicitudes

POST · JSON

```sh
curl https://200ok.hacks.run/echo \
  -H 'Content-Type: application/json' \
  --data-binary '{"name":"Bob"}'
```

POST · Texto sin formato

```sh
curl https://200ok.hacks.run/echo \
  -H 'Content-Type: text/plain' \
  --data-binary 'Hello!'
```

POST · Formulario

```sh
curl https://200ok.hacks.run/echo \
  --data-urlencode 'name=Bob' \
  --data-urlencode 'age=42'
```

POST · Archivo binario

```sh
curl https://200ok.hacks.run/echo \
  -H 'Content-Type: application/octet-stream' \
  --data-binary '@./file.bin'
```

#### Respuestas

##### 200 OK

El método y el cuerpo de la solicitud procesado. Este ejemplo es una solicitud GET sin cuerpo.

Ejemplo · text/plain

```
GET

null
```

Ejemplo · application/json

```
{"method":"GET","body":null}
```

Esquema · object

| Campo | Tipo | Descripción |
| --- | --- | --- |
| `method`obligatorio | `string` | El método HTTP de la solicitud. |
| `body`obligatorio | `object | array | string | number | boolean | null` | Un valor JSON, una cadena, campos de formulario o un cuerpo binario { encoding: 'base64', sizeBytes: number, data: string }. Null cuando no se proporciona un cuerpo. |

**body · objeto binario**

| Campo | Tipo | Descripción |
| --- | --- | --- |
| `encoding`obligatorio | `string` | Siempre `"base64"`. |
| `sizeBytes`obligatorio | `integer` | Número de bytes originales. |
| `data`obligatorio | `string` | Contenido codificado en Base64. |

Ejemplo · application/json

```
{
  "method": "GET",
  "body": null
}
```

Esquema · object

| Campo | Tipo | Descripción |
| --- | --- | --- |
| `method`obligatorio | `string` | El método HTTP de la solicitud. |
| `body`obligatorio | `object | array | string | number | boolean | null` | Un valor JSON, una cadena, campos de formulario o un cuerpo binario { encoding: 'base64', sizeBytes: number, data: string }. Null cuando no se proporciona un cuerpo. |

**body · objeto binario**

| Campo | Tipo | Descripción |
| --- | --- | --- |
| `encoding`obligatorio | `string` | Siempre `"base64"`. |
| `sizeBytes`obligatorio | `integer` | Número de bytes originales. |
| `data`obligatorio | `string` | Contenido codificado en Base64. |

##### 413 Payload Too Large

El cuerpo supera los 102 400 bytes (100 KiB).

Ejemplo · text/plain

```
Request body exceeds the size limit of 100 KiB
```

Ejemplo · application/json

```
{"error":"Request body exceeds the size limit of 100 KiB","limitBytes":102400}
```

Esquema · object

| Campo | Tipo | Descripción |
| --- | --- | --- |
| `error`obligatorio | `string` | Descripción del error. |
| `limitBytes`obligatorio | `integer` | Tamaño máximo del cuerpo en bytes. Valor: `102400`. |

Ejemplo · application/json

```
{
  "error": "Request body exceeds the size limit of 100 KiB",
  "limitBytes": 102400
}
```

Esquema · object

| Campo | Tipo | Descripción |
| --- | --- | --- |
| `error`obligatorio | `string` | Descripción del error. |
| `limitBytes`obligatorio | `integer` | Tamaño máximo del cuerpo en bytes. Valor: `102400`. |

##### 415 Unsupported Media Type

Content-Type no admitido o ausente en un cuerpo no vacío.

Ejemplo · text/plain

```
Unsupported Content-Type. Supported: application/json, text/plain, application/x-www-form-urlencoded, application/octet-stream
```

Ejemplo · application/json

```
{"error":"Unsupported Content-Type. Supported: application/json, text/plain, application/x-www-form-urlencoded, application/octet-stream"}
```

Esquema · object

| Campo | Tipo | Descripción |
| --- | --- | --- |
| `error`obligatorio | `string` | Descripción del error. |

Ejemplo · application/json

```
{
  "error": "Unsupported Content-Type. Supported: application/json, text/plain, application/x-www-form-urlencoded, application/octet-stream"
}
```

Esquema · object

| Campo | Tipo | Descripción |
| --- | --- | --- |
| `error`obligatorio | `string` | Descripción del error. |

Un JSON no válido devuelve 400. Los errores de la API usan el formato de salida seleccionado: texto sin formato o JSON.

## Headers

### [`/headers`](https://200ok.hacks.run/headers)

GET

Las cabeceras de la solicitud entrante.

**Detalles**

#### Ejemplos de solicitudes

Con una cabecera personalizada

```sh
curl https://200ok.hacks.run/headers \
  -H 'X-Test: hello'
```

#### Respuestas

##### 200 OK

Cabeceras de la solicitud entrante. Los nombres y valores dependen del cliente.

Ejemplo · text/plain

```
host:  localhost:3000

accept:  */*
```

Ejemplo · application/json

```
{"host":"localhost:3000","accept":"*/*"}
```

Esquema · object

| Campo | Tipo | Descripción |
| --- | --- | --- |
| `[nombre de la cabecera]` | `string | string[]` | Valor de la cabecera. |

Ejemplo · application/json

```
{
  "host": "localhost:3000",
  "accept": "*/*"
}
```

Esquema · object

| Campo | Tipo | Descripción |
| --- | --- | --- |
| `[nombre de la cabecera]` | `string | string[]` | Valor de la cabecera. |
