---
title: "Tu Primera Petición"
description: "Realiza tu primera consulta exitosa a la API de API Gateway usando Swagger UI"
type: "academy"
category: "lesson"
tags: []
authors: [Anonymous]
date: "2026-08-27"
last_update: "2026-08-21"
time_minutes: 4
draft: false
unlisted: false
url: "https://www.stage.apigateway.cl/academy/capacitacion-inicial/primeros-pasos/primera-peticion"
---

# Tu Primera Petición

Es momento de hacer tu primera petición real a la API. Comenzaremos con algo simple: validar un RUT. Este endpoint no requiere autenticación en el SII, por lo que es perfecto para empezar.

---

## Paso 1: Obtener tu Access Token

### ¿Qué es un Access Token?

Es tu "llave" para usar la API. Todas las peticiones deben incluir este token para identificarte como usuario autorizado.

### Dónde Obtenerlo

1. Ingresa a tu [Dashboard de API Gateway](https://legacy.apigateway.cl/dashboard)
2. En la sección **"[API Auth](https://legacy.apigateway.cl/dashboard#api-auth)"** podrás crear un nuevo token.
3. Haz clic en **"Crear Token"**
4. Copia el token generado.

> [!INFO] Importante
>
> Este token es como una contraseña. No lo compartas ni lo subas a repositorios públicos.

---

## Paso 2: Configurar Autorización en Swagger

### Proceso de Autorización

1. En Swagger UI, busca el botón **"Authorize"** 🔐 (parte superior derecha)
2. Se abrirá un modal de autorización
3. En el campo **"Value"**, ingresa:
   ```
   Bearer sk_live_50kB1cGciOiJSUzI1NiIsInR5c...
   ```

> [!NOTE] Nota
>
> Incluye la palabra "Bearer" seguida de un espacio antes del token

4. Haz clic en **"Authorize"**
5. El botón mostrará un candado cerrado 🔒 indicando que estás autenticado

### Verificar Autorización

Si la autorización fue exitosa:
- El candado aparece cerrado 🔒
- Verás tu token parcialmente oculto
- Opción para "Logout" disponible

---

## Paso 3: Seleccionar el Endpoint

### Endpoint Situación Tributaria de un Contribuyente

Busca en la sección **"API Contribuyentes"**:

```
GET /api/v1/sii/contribuyentes/situacion_tributaria/tercero/{rut}
```



**¿Por qué este endpoint?**
- Es simple (solo requiere un parámetro)
- No necesita autenticación SII
- Respuesta inmediata
- Útil para obtener la situación tributaria de un contribuyente

### Expandir el Endpoint

1. Haz clic sobre el endpoint
2. Se desplegará mostrando:
   - Descripción completa
   - Parámetros requeridos
   - Posibles respuestas

---

## Paso 4: Configurar la Petición

### Activar Modo de Prueba

1. Haz clic en **"Try it out"**
2. Los campos se vuelven editables

### Completar Parámetros

Para este endpoint solo necesitas:

```
Path Parameters
───────────────
rut*: 76192083-9
```

**Formato del RUT**:
- Sin puntos
- Con guión
- Con dígito verificador
- Ejemplo: `76192083-9` ✅
- No usar: `76.192.083-9` ❌

---

## Paso 5: Ejecutar la Petición

### Enviar la Solicitud

1. Verifica que el RUT esté correctamente ingresado
2. Haz clic en **"Execute"**
3. Swagger enviará la petición a la API

### Qué Sucede al Ejecutar

1. Swagger construye la petición completa
2. Añade tu Bearer Token automáticamente
3. Envía la solicitud al servidor
4. Espera la respuesta
5. Muestra los resultados

---

## Paso 6: Interpretar la Respuesta

### Respuesta Exitosa (200 OK)

```json
{
  "actividades": [
    {
      "afecta": true,
      "categoria": 1,
      "codigo": "620200",
      "glosa": "ACTIVIDADES DE CONSULTORIA DE INFORMATICA Y DE GESTION DE INSTALACIONE"
    }
  ],
  "documentos_timbrados": [
    {
      "documento": "Factura Electronica",
      "ultimo_timbraje": 2020
    },
  ],
  "dv": "9",
  "excepcion_dte": false,
  "fecha_inicio_actividades": "2012-06-08",
  "inicio_actividades": true,
  "moneda_extranjera": false,
  "obligacion_dte": true,
  "observaciones": {
    "actividad_esporadica": false,
    "domicilio_inexistente": false,
    "inconcurrente": false,
    "no_habido_domicilio": false,
    "no_ubicado": false,
    "suplantado": false,
    "termino_giro": false,
    "termino_giro_obligatorio": false
  },
  "pro_pyme": true,
  "razon_social": "SASCO SPA",
  "rut": 76192083
}
```

**Campos de la respuesta**:
| Campo | Descripción |
|-------|-------------|
| `valido` | true si el RUT es válido |
| `rut` | RUT sin formato |
| `dv_calculado` | Dígito verificador correcto |
| `dv_ingresado` | Dígito que proporcionaste |
| `formato_completo` | RUT con puntos y guión |

### Headers de Respuesta

```
content-type: application/json
x-ratelimit-limit: 1000
x-ratelimit-remaining: 999
x-request-id: 550e8400-e29b-41d4
```

**Headers importantes**:
| Header | Significado |
|--------|-------------|
| `x-ratelimit-limit` | Peticiones máximas por hora |
| `x-ratelimit-remaining` | Peticiones restantes |
| `x-request-id` | ID único de esta petición |

---

## Analizando el cURL

Swagger genera automáticamente el comando cURL:

```bash
curl -X 'GET' \
  'https://legacy.apigateway.cl/api/v1/sii/contribuyentes/situacion_tributaria/tercero/76192083-9' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer sk_live_50kB1cGciOiJSUzI1NiIsInR5c...'
```

**Componentes del comando**:
- `-X 'GET'`: Método HTTP
- URL completa con el RUT
- `-H 'accept: application/json'`: Esperamos JSON
- `-H 'Authorization: ...'`: Tu token de acceso

---

## Ejercicios Adicionales

### 1. Probar con RUT Inválido

Intenta con: `11111111-2` (dígito verificador incorrecto)

Respuesta esperada:
```json
{
    "rut": 11111111,
    "dv": "2",
    "razon_social": null,
    "inicio_actividades": null
}
```

### 2. Probar sin Autorización

1. Haz "Logout" en el modal de autorización
2. Ejecuta la misma petición
3. Observa el error 401

Respuesta esperada:
```json
{
  "message": "Unauthenticated."
}
```

### 3. Explorar Otro Endpoint Simple

Prueba con:
```
GET /api/v1/sii/contribuyentes/actividades_economicas
```

Este endpoint retorna el listado de actividades económicas.


---
Last updated on 21/08/2026