# Qué es una API: definición, cómo funciona, tipos y ejemplos

> Una API es la puerta por la que un programa pide datos o servicios a otro, con unas reglas fijas. Definición, cómo funciona, REST, tipos, seguridad y ejemplos reales.

- URL canónica: https://crearsoftware.com/blog/que-es-una-api/
- Publicado: 2026-11-21
- Autor: Alfonso Gutiérrez
- Categoría: Desarrollo de Software
- Fuente: Crear Software (https://crearsoftware.com)

---

**Una API es la puerta por la que un programa le pide datos o servicios a otro programa. Fija las reglas de la conversación: qué se puede pedir, cómo hay que pedirlo y qué forma tendrá la respuesta. Quien la usa no necesita saber cómo está hecho el programa del otro lado; solo necesita conocer esas reglas. Cuando una tienda online cobra con tarjeta, cuando una app enseña el tiempo o cuando un ERP envía una factura a Hacienda, hay una API por medio.**

La sigla viene del inglés *Application Programming Interface*, **interfaz de programación de aplicaciones**. La palabra importante es *interfaz*: el punto de contacto entre dos cosas. La pantalla de un programa es su interfaz con las personas. La API es su interfaz con otros programas.

Este artículo es la cuarta pieza de una serie sobre los fundamentos de la informática. Las anteriores explican el [hardware](/blog/que-es-el-hardware/), el [sistema operativo](/blog/que-es-un-sistema-operativo/) y el [software libre](/blog/que-es-el-software-libre/). Esta trata de cómo se hablan entre sí los programas.

## Definición

> **API** (*Application Programming Interface*, interfaz de programación de aplicaciones): conjunto de reglas y operaciones que un programa pone a disposición de otros para que puedan pedirle datos o servicios. Define qué operaciones existen, qué datos hay que enviar en cada una y qué devuelve. Lo que hay detrás queda oculto.

La última frase es la clave. Una API separa **lo que un programa ofrece** de **cómo lo hace**. El banco puede cambiar su base de datos, su lenguaje de programación o sus servidores, y mientras la API siga igual, la tienda que cobra con él no se entera. Por eso se dice que una API es un **contrato**: el que la publica se compromete a responder de una forma, y el que la usa, a preguntar de otra.

No es una idea nueva. Las bibliotecas de [funciones](/blog/que-es-una-funcion-en-programacion/) de los primeros ordenadores, en los años cincuenta, ya funcionaban así: se sabía qué hacía cada subrutina y qué había que darle, no cómo estaba escrita por dentro. Lo que ha cambiado es la distancia. Hoy la mayoría de las APIs de las que se habla están en otro ordenador, y se llaman a través de internet.

## Un ejemplo real: pedirle el IPC al INE

La forma más rápida de entender una API es usar una. El Instituto Nacional de Estadística tiene una API pública y gratuita, sin registro. Hoy, 21 de noviembre de 2026, he pedido la última tasa de variación anual del IPC con esta dirección:

```
GET https://servicios.ine.es/wstempus/js/ES/DATOS_SERIE/IPC290750?nult=1
```

Cada parte significa algo:

| Parte | Qué es |
| --- | --- |
| `GET` | El **método**: qué se quiere hacer. GET es leer |
| `servicios.ine.es` | El servidor que responde |
| `/wstempus/js/ES/DATOS_SERIE/` | La operación: datos de una serie, en formato JSON y en español |
| `IPC290750` | El código de la serie: IPC nacional, índice general, variación anual |
| `?nult=1` | Un **parámetro**: solo el último dato |

Y esta es la respuesta, que llegó con el código `200 OK`. Solo le he añadido saltos de línea para que se lea mejor; los datos son los que envió el INE:

```json
{
  "COD": "IPC290750",
  "Nombre": "Nacional. Índice general. Variación anual. ",
  "FK_Unidad": 135,
  "FK_Escala": 1,
  "Data": [
    {
      "Fecha": 1790805600000,
      "FK_TipoDato": 1,
      "FK_Periodo": 10,
      "Anyo": 2026,
      "Valor": 4.9,
      "Secreto": false
    }
  ]
}
```

La respuesta no es una página web, es texto con estructura. El dato está en `Valor`: **4,9 %**, la tasa anual del IPC de octubre de 2026 (`Anyo` 2026, `FK_Periodo` 10). La `Fecha` es el número de milisegundos desde el 1 de enero de 1970, la forma habitual de guardar fechas en informática: corresponde al 1 de octubre de 2026 a medianoche, hora de Madrid. Una persona no lee esto con gusto. Un programa lo lee sin ambigüedad, que es para lo que está hecho.

### La lección que trajo el ejemplo

La primera vez pedí otra serie, la `IPC251856`, con el mismo nombre: «Nacional. Índice general. Variación anual». La API respondió `200 OK` sin queja y me dio **2,9 %**. Pero el dato era de diciembre de 2025. La propia API, al pedirle los detalles de cada serie, lo explica: la antigua pertenece a la clasificación «Base 2021», y la que se actualiza hoy, a la «Base 2025». El INE cambió la base del IPC y publicó las series nuevas con códigos nuevos.

Un programa que siguiera usando el código viejo no daría ningún error. Enseñaría el IPC de diciembre de 2025 durante años, con total tranquilidad. **Que una API responda bien no quiere decir que el dato sea el que crees.** Las APIs cambian, se versionan y se jubilan, y quien depende de una tiene que vigilarlo.

## Cómo funciona una API web

Casi todas las APIs que se usan hoy entre empresas viajan por **HTTP**, el mismo protocolo que usa el navegador para pedir páginas. La conversación tiene siempre dos partes: una **petición** y una **respuesta**.

La petición lleva:

- **Una dirección** (*endpoint*): la URL de la operación, como la del INE.
- **Un método**: qué se quiere hacer con lo que hay en esa dirección.
- **Cabeceras**: datos sobre la propia petición. Por ejemplo, en qué formato va el contenido o la clave que identifica a quien pregunta.
- **Un cuerpo**, a veces: los datos que se envían. Al crear un cliente, su nombre, su NIF y su dirección.

La respuesta lleva un **código de estado**, sus propias cabeceras y, normalmente, un cuerpo con los datos.

### Los métodos

| Método | Para qué | Ejemplo |
| --- | --- | --- |
| GET | Leer | Consultar una factura |
| POST | Enviar datos para que el servidor los procese; a menudo, crear algo | Dar de alta un pedido |
| PUT | Sustituir algo entero | Reemplazar la ficha de un cliente |
| PATCH | Modificar una parte | Cambiar solo el teléfono del cliente |
| DELETE | Borrar | Anular una cita |

GET, POST, PUT y DELETE están definidos en la especificación de HTTP vigente, el RFC 9110, de junio de 2022. PATCH se añadió aparte, en el RFC 5789, de marzo de 2010.

### Los códigos de estado

El código de tres cifras dice cómo ha ido. La primera cifra da la familia: 2 es éxito, 3 es redirección, 4 es un error de quien pregunta y 5 es un error del servidor.

| Código | Significa | Lo normal |
| --- | --- | --- |
| 200 | OK | Todo bien |
| 201 | Created | Se ha creado lo que se pidió |
| 400 | Bad Request | La petición está mal formada |
| 401 | Unauthorized | No te has identificado, o la clave no vale |
| 403 | Forbidden | Te has identificado, pero no tienes permiso |
| 404 | Not Found | Eso no existe |
| 429 | Too Many Requests | Has hecho demasiadas peticiones; espera |
| 500 | Internal Server Error | El servidor ha fallado |
| 503 | Service Unavailable | El servicio no está disponible ahora |

La diferencia entre 401 y 403 ahorra horas. El 23 de agosto de 2026, todas las peticiones del programa que saca los datos de Google Search Console para este blog empezaron a recibir 403. Lo primero que pensé fue que la credencial había caducado, porque ya había pasado antes. Pero la credencial seguía funcionando. El 403 decía otra cosa: Google sabía quién llamaba y no le dejaba ver el sitio, porque se había perdido la verificación de la propiedad. Regenerar la credencial no habría arreglado nada; volver a verificar el sitio lo arregló el mismo día.

El 429 viene de otro documento, el RFC 6585, de abril de 2012. Es el código con el que una API dice que se ha superado el límite de uso.

### El formato: JSON

La respuesta del INE está en **JSON** (*JavaScript Object Notation*), el formato más extendido en las APIs actuales. Es texto plano con dos estructuras: listas entre corchetes y pares de nombre y valor entre llaves. Su especificación es el RFC 8259, de diciembre de 2017, y cabe en unas pocas páginas. Antes dominaba **XML**, con etiquetas como las de HTML, que sigue muy presente en banca y administración.

## Qué es una API REST

Cuando alguien dice «API REST» se refiere a una API web que sigue, más o menos, un estilo de arquitectura con nombre propio. **REST** (*Representational State Transfer*) lo describió Roy Fielding en el capítulo 5 de su tesis doctoral, presentada en la Universidad de California en Irvine en 2000. Fielding había sido uno de los autores de la especificación de HTTP, y en la tesis explica que REST fue el modelo con el que se guio el diseño de la arquitectura de la web moderna.

La tesis define REST como un conjunto de restricciones:

1. **Cliente-servidor.** Quien pregunta y quien responde están separados y evolucionan por su cuenta.
2. **Sin estado.** Cada petición lleva todo lo necesario para entenderla. El servidor no recuerda la conversación anterior.
3. **Caché.** Las respuestas dicen si se pueden guardar y reutilizar.
4. **Interfaz uniforme.** Todo se trata como recursos con su dirección, y se manejan siempre con las mismas operaciones.
5. **Sistema en capas.** Entre cliente y servidor puede haber intermediarios, como cachés o balanceadores, sin que el cliente lo sepa.
6. **Código bajo demanda.** El servidor puede enviar código para que lo ejecute el cliente. Es la única restricción opcional.

En la práctica, «API REST» se usa con manga ancha: una API con direcciones que nombran cosas (`/clientes/42`), métodos HTTP para las operaciones y respuestas en JSON. Muchas de las que se llaman REST no cumplen todas las restricciones de la tesis. La del INE, con sus operaciones en la dirección, se parece más a una consulta que a un recurso.

## Tipos de API

Se clasifican de dos maneras: por quién puede usarlas y por cómo están hechas.

### Por quién puede usarlas

| Tipo | Quién la usa | Ejemplo |
| --- | --- | --- |
| **Privada o interna** | Los equipos de la propia empresa | La que conecta la web de una tienda con su almacén |
| **De socios** | Empresas con un acuerdo | La de un banco para los comercios que cobran con él |
| **Pública** | Cualquiera, a veces con registro | La del INE |

### Por cómo están hechas

- **REST.** La más común en APIs web. HTTP y, casi siempre, JSON.
- **SOAP.** Mensajes en XML con un sobre y un contrato formal que describe cada operación. Más pesada y más estricta. Sigue viva en banca, seguros y administración.
- **GraphQL.** El cliente escribe una consulta que dice exactamente qué campos quiere, y recibe solo eso, en una sola petición. La creó Facebook en 2012 y la publicó como código abierto en 2015.
- **gRPC.** Pensada para la comunicación entre servicios internos, con mensajes binarios más compactos que JSON.
- **Webhooks.** Es la conversación al revés: en lugar de preguntar cada rato «¿ha pasado algo?», le das al otro sistema una dirección tuya y él te llama cuando pasa. La pasarela de pago avisa a la tienda de que un cobro se ha confirmado.

### Las APIs que no son web

No toda API está en internet. Cuando un programa le pide al sistema operativo que abra un archivo, hace una [llamada al sistema](/blog/que-es-un-sistema-operativo/), y el conjunto de esas llamadas es la API del sistema operativo. Cuando un programa en Python usa una biblioteca para leer una hoja de cálculo, usa la API de esa biblioteca: el nombre de cada función, sus parámetros y lo que devuelve. El principio es el mismo: un contrato que oculta cómo están hechas las cosas.

## Las cuatro APIs de este blog

Este blog no tiene servidor propio ni base de datos, y aun así habla con cuatro APIs cada semana. Las saco del código de sus scripts de mantenimiento:

| API | Para qué la uso | Cómo se identifica uno |
| --- | --- | --- |
| Google Search Console | Saber qué páginas están indexadas y cuántas veces salen en Google | OAuth 2.0: un permiso concedido por la cuenta, sin compartir la contraseña |
| Bing Webmaster Tools | Lo mismo en Bing, y la demanda de búsquedas de temas que aún no cubro | Una clave de API |
| IndexNow | Avisar a Bing y otros buscadores de que hay una página nueva | Un fichero con una clave publicado en la raíz del sitio |
| Cloudflare | Saber qué rastreadores de IA visitan el blog | Un token con permisos limitados |

IndexNow es la más sencilla. Es un POST con un cuerpo JSON que dice el dominio, la clave, dónde está publicada la clave y la lista de URLs. Si todo va bien, la respuesta es un 200 y nada más. Este mismo artículo se anunció así después de publicarse.

Las cuatro se identifican de forma distinta, y eso es lo normal: cada API decide cómo sabe quién llama.

## Las APIs en la empresa

Para una empresa, las APIs son la forma en que su software deja de ser una isla.

- **Integraciones.** El [ERP](/2007/10/30/que-es-una-erp/) recibe los pedidos de la tienda online, el [CRM](/2012/06/22/que-es-un-crm/) lee las facturas del ERP y la herramienta de nóminas envía los asientos a contabilidad. Cada una de esas flechas es una API, o debería serlo. La alternativa son ficheros exportados a mano y vueltos a importar, con sus errores.
- **Productos que son una API.** Hay empresas cuyo producto entero es una API: cobros, envío de SMS, mapas, traducción. Se paga por uso, normalmente por número de peticiones.
- **Obligaciones legales.** En España, el reglamento de los sistemas de facturación (Real Decreto 1007/2023, el de Verifactu) obliga a que el software de facturación cumpla unos requisitos técnicos. La modalidad VERI\*FACTU consiste en que el programa remite cada registro de facturación a la Agencia Tributaria de forma automática, y la orden que lo desarrolla (Orden HAC/1177/2024) fija que esa remisión se hace con mensajes en formato XML. Tras la modificación de diciembre de 2025, los contribuyentes del Impuesto sobre Sociedades tienen que tener los sistemas adaptados antes del 1 de enero de 2027, y el resto, antes del 1 de julio de 2027. Es una API que un programa de facturación tiene que saber usar.

El ejemplo más citado de lo que cambia una empresa cuando se organiza alrededor de APIs es Amazon. Steve Yegge, que trabajó allí, contó en 2011 que Jeff Bezos dio una orden «hacia 2002, más o menos un año»: todos los equipos debían ofrecer sus datos y funciones a través de interfaces de servicio, y comunicarse solo a través de ellas. La orden terminaba diciendo que quien no lo hiciera sería despedido. Es un relato de un exempleado, no un documento de la empresa. Pero el 14 de marzo de 2006 Amazon anunció **Amazon S3**, un almacenamiento en la nube que se vendía, como decía el propio comunicado, como una interfaz de programación para desarrolladores. Lo conté con más detalle, junto con la historia de la App Store, en [API, apps y extensiones](/2021/01/23/api-apps-y-extensiones/).

## Seguridad: el fallo más común

Una API abre una puerta a los datos de la empresa, y por eso es uno de los sitios por donde más se ataca. La fundación OWASP publica una lista de los diez riesgos más importantes en APIs. En su edición de 2023, el primero es la **autorización rota a nivel de objeto** (*Broken Object Level Authorization*).

El nombre es técnico, pero el fallo es muy simple. Un cliente pide su factura:

```
GET /api/facturas/1001
```

Y luego prueba a cambiar el número:

```
GET /api/facturas/1002
```

Si la API comprueba que quien pregunta ha iniciado sesión, pero no comprueba que la factura 1002 sea suya, le devuelve la de otro cliente. El servidor sabe quién eres y no se pregunta si eso es tuyo. Es la diferencia entre autenticar (saber quién llama) y autorizar (decidir qué puede ver). La misma diferencia que hay entre el 401 y el 403.

Las otras reglas básicas:

- **Las claves no van en el código** que se publica, sino en un fichero aparte que no se comparte. Lo mejor es enviarlas en las cabeceras y no en la dirección, porque las direcciones acaban en los registros de los servidores. No siempre se puede elegir: la API de Bing Webmaster Tools que usa este blog pide la clave como parámetro de la dirección.
- **Cada clave, con el mínimo permiso.** Una clave que solo lee no puede borrar aunque se filtre.
- **Límite de peticiones.** Sin él, un error en un bucle o un abuso puede tumbar el servicio. Para eso existe el 429.
- **Inventario.** La edición de 2023 de OWASP incluye también la mala gestión del inventario: versiones antiguas de una API que nadie recuerda y siguen abiertas. Es el caso del IPC visto desde el otro lado.

## Las APIs y la inteligencia artificial

La inteligencia artificial ha hecho de las APIs algo todavía más central, por dos lados.

Primero, los modelos de lenguaje se usan sobre todo a través de APIs. Una empresa que añade un asistente a su programa no instala el modelo: le envía el texto a la API del proveedor y recibe la respuesta. Se paga por [tokens](/blog/que-es-un-token-en-ia-definicion/), que son los trozos de texto que el modelo procesa.

Segundo, los asistentes necesitan APIs para hacer cosas, no solo para hablar. Para que un asistente consulte un pedido en el ERP o cree una cita en el calendario, tiene que poder llamar a la API de ese sistema. El 25 de noviembre de 2024, Anthropic publicó como código abierto el **Model Context Protocol** (MCP), un estándar para conectar los asistentes de IA con los sistemas donde están los datos: repositorios de contenido, herramientas de negocio y entornos de desarrollo. Es, en el fondo, una forma común de describir APIs para que un modelo sepa usarlas.

## Una historia en ocho fechas

| Año | Qué pasó |
| --- | --- |
| Años 50 | Las primeras bibliotecas de subrutinas: se usa una función sin saber cómo está escrita |
| 2000 | Roy Fielding describe REST en su tesis doctoral |
| Hacia 2002 | Orden de Bezos en Amazon, según el relato de Steve Yegge |
| 2006 | Amazon anuncia S3, el 14 de marzo |
| 2015 | Facebook publica GraphQL como código abierto |
| 2017 | JSON queda especificado en el RFC 8259 |
| 2023 | OWASP publica su lista de riesgos en APIs vigente |
| 2024 | Anthropic publica el Model Context Protocol |

## Confusiones frecuentes

- **API no es lo mismo que base de datos.** La API está delante de los datos y decide qué se puede pedir. La base de datos está detrás y no se toca desde fuera.
- **API no es lo mismo que SDK.** Un SDK (*Software Development Kit*) es un paquete de herramientas para programar contra una plataforma, que suele incluir bibliotecas para usar su API cómodamente. La API es el contrato; el SDK, una ayuda para cumplirlo.
- **API no es lo mismo que clave de API.** La clave es solo el dato que identifica a quien llama.
- **API e interfaz de usuario son primas, no hermanas.** Las dos son interfaces, pero una la usan personas y la otra programas. Los principios de [diseño de una interfaz](/2012/04/24/que-es-una-interface/) para personas no sirven para una API: un programa no se cansa de leer, pero no tolera la ambigüedad.
- **«Web service» y API web** se usan casi como sinónimos. Por costumbre, «web service» suena a SOAP y XML, y «API» a REST y JSON.

## Preguntas frecuentes

### ¿Qué es una API?

Es la puerta por la que un programa le pide datos o servicios a otro, con unas reglas fijas: qué se puede pedir, cómo pedirlo y qué forma tiene la respuesta. Quien la usa no necesita saber cómo está hecho el programa del otro lado.

### ¿Qué significa API?

Es la sigla de *Application Programming Interface*, interfaz de programación de aplicaciones. Es la interfaz de un programa con otros programas, igual que la pantalla es su interfaz con las personas.

### ¿Para qué sirve una API?

Para que programas distintos trabajen juntos sin conocer sus tripas: que una tienda cobre a través de un banco, que una app muestre el tiempo, que un ERP envíe facturas a Hacienda o que un asistente de IA consulte un pedido.

### ¿Qué es una API REST?

Es una API web que sigue el estilo REST, descrito por Roy Fielding en 2000: direcciones que nombran recursos, métodos HTTP (GET, POST, PUT, DELETE) para operar sobre ellos y peticiones independientes entre sí. Las respuestas suelen ir en JSON.

### ¿Qué es un endpoint?

Es la dirección concreta de una operación de una API. En la API del INE, `https://servicios.ine.es/wstempus/js/ES/DATOS_SERIE/IPC290750` es el endpoint que devuelve los datos de una serie.

### ¿Qué es una API key?

Es una clave, una cadena de caracteres, que identifica a quien llama a una API. Sirve para saber quién usa el servicio, limitar cuánto lo usa y, si es de pago, cobrarle. Se envía en las cabeceras de la petición y no se publica.

### ¿Qué diferencia hay entre una API y un SDK?

La API es el contrato: las operaciones que ofrece un servicio. El SDK es un paquete de herramientas para programar contra ese servicio, que suele incluir bibliotecas que llaman a la API por ti.

### ¿Qué ejemplos de API hay?

La del INE para consultar estadísticas, las de pasarelas de pago, las de mapas, las de los modelos de inteligencia artificial, el servicio de la Agencia Tributaria que recibe los registros de facturación de VERI\*FACTU, o las llamadas al sistema con las que cualquier programa usa el sistema operativo.

## Fuentes

- Instituto Nacional de Estadística, [API JSON de INEbase](https://www.ine.es/dyngs/DAB/index.htm?cid=1099). Peticiones a las series `IPC290750` e `IPC251856` y a sus metadatos, hechas el 21 de noviembre de 2026.
- Roy T. Fielding, [*Architectural Styles and the Design of Network-based Software Architectures*](https://ics.uci.edu/~fielding/pubs/dissertation/top.htm), tesis doctoral, Universidad de California en Irvine, 2000. [Capítulo 5: REST](https://ics.uci.edu/~fielding/pubs/dissertation/rest_arch_style.htm).
- IETF, [RFC 9110, *HTTP Semantics*](https://www.rfc-editor.org/rfc/rfc9110.html), junio de 2022.
- IETF, [RFC 5789, *PATCH Method for HTTP*](https://www.rfc-editor.org/rfc/rfc5789.html), marzo de 2010.
- IETF, [RFC 6585, *Additional HTTP Status Codes*](https://www.rfc-editor.org/rfc/rfc6585.html), abril de 2012.
- IETF, [RFC 8259, *The JavaScript Object Notation (JSON) Data Interchange Format*](https://www.rfc-editor.org/rfc/rfc8259.html), diciembre de 2017.
- OWASP, [API Security Top 10, edición de 2023](https://owasp.org/API-Security/editions/2023/en/0x11-t10/).
- GraphQL Foundation, [página de la fundación](https://graphql.org/foundation/): creada en 2012 y publicada como código abierto por Facebook en 2015.
- Amazon, [comunicado de lanzamiento de Amazon S3](https://press.aboutamazon.com/2006/3/amazon-web-services-launches), 14 de marzo de 2006.
- Steve Yegge, [*Stevey's Google Platforms Rant*](https://gist.github.com/chitchcock/1281611), 2011.
- Anthropic, [*Introducing the Model Context Protocol*](https://www.anthropic.com/news/model-context-protocol), 25 de noviembre de 2024.
- [Real Decreto 1007/2023, de 5 de diciembre](https://www.boe.es/buscar/act.php?id=BOE-A-2023-24840), texto consolidado con la modificación del Real Decreto-ley 15/2025, de 2 de diciembre (BOE).
- [Orden HAC/1177/2024, de 17 de octubre](https://www.boe.es/buscar/act.php?id=BOE-A-2024-22138) (BOE).
- Código de los scripts de mantenimiento de este blog, leído el 21 de noviembre de 2026.

## Serie «Fundamentos de informática» (4 de 4)

1. [Qué es el hardware: definición, componentes, tipos y ejemplos](https://crearsoftware.com/blog/que-es-el-hardware/)
2. [Qué es un sistema operativo: definición, funciones, tipos y ejemplos](https://crearsoftware.com/blog/que-es-un-sistema-operativo/)
3. [Qué es el software libre: definición, las cuatro libertades, licencias y ejemplos](https://crearsoftware.com/blog/que-es-el-software-libre/)
4. **Qué es una API: definición, cómo funciona, tipos y ejemplos** (este artículo)

---

Contenido de Crear Software. Citable indicando la fuente y enlazando a https://crearsoftware.com/blog/que-es-una-api/.
