> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firecrawl.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# API de integración para socios

> Referencia de la API para socios autorizados de Firecrawl que permite crear y gestionar claves de API para sus usuarios

<div id="overview">
  ## Resumen
</div>

La API de integración para socios de Firecrawl permite a los socios aprobados crear y gestionar claves de API de Firecrawl para sus usuarios directamente desde su propia plataforma. Esto ofrece una experiencia de incorporación fluida en la que los usuarios pueden empezar a usar Firecrawl sin salir de la plataforma del socio.

<Note>
  El acceso a la API para socios **solo está disponible para los socios aprobados de Firecrawl**. Las claves de socio se comparten de forma privada con los socios aprobados. Para solicitar el programa de socios o pedir una clave de API para socios, envía un correo a [partnerships@firecrawl.dev](mailto:partnerships@firecrawl.dev).
</Note>

Para obtener más información sobre lo que reciben los usuarios de socios, incluidos los créditos, la caducidad y los límites del plan, consulta [Partner Credits](/es/partner-credits).

<div id="base-url">
  ## URL base
</div>

```
https://integrations.firecrawl.dev
```

<div id="authentication">
  ## Autenticación
</div>

Todas las solicitudes a la API de integración para socios requieren una cabecera `Authorization` con tu clave de socio:

```bash theme={null}
Authorization: Bearer <partner key>
```

Las claves de socio son distintas de las claves de API estándar de Firecrawl y el equipo de Firecrawl las proporciona directamente.

<div id="security-requirements">
  ## Requisitos de seguridad
</div>

* **Solo en el servidor**: Las claves de socio solo deben usarse en código del lado del servidor. Nunca expongas una clave de socio en código de frontend, JavaScript del lado del cliente ni en aplicaciones móviles.
* **Términos del servicio**: Antes de llamar a `POST /partner/v1/accounts`, tu plataforma debe solicitar al usuario que acepte los [Términos del servicio](https://www.firecrawl.dev/terms-of-service) de Firecrawl.

***

<div id="endpoints">
  ## Endpoints
</div>

<div id="create-user">
  ### Crear usuario
</div>

Crea una clave de API de Firecrawl asociada a la dirección de correo electrónico del usuario.

```
POST /partner/v1/accounts
```

<div id="behavior">
  #### Comportamiento
</div>

* Si el usuario aún no tiene una cuenta de Firecrawl, se crearán un nuevo usuario y un nuevo equipo.
* Si el usuario ya tiene una cuenta de Firecrawl pero no tiene un equipo asociado a la integración de tu partner, se creará un nuevo equipo asociado a ese partner.
* Si el usuario ya tiene una cuenta de Firecrawl y ya tiene un equipo asociado a la integración de tu partner, se devolverá el equipo existente y el cupón promocional **no** se volverá a aplicar.

<div id="request">
  #### Solicitud
</div>

```bash cURL theme={null}
curl -X POST "https://integrations.firecrawl.dev/partner/v1/accounts" \
  -H "Authorization: Bearer <partner key>" \
  -H "Content-Type: application/json" \
  -d '{"email": "user@example.com"}'
```

**Cuerpo**

| Campo   | Tipo   | Obligatorio | Descripción                                    |
| ------- | ------ | ----------- | ---------------------------------------------- |
| `email` | string | Sí          | La dirección de correo electrónico del usuario |

<div id="response">
  #### Respuesta
</div>

**`200 OK`**

```json theme={null}
{
  "apiKey": "fc-...",
  "alreadyExisted": false
}
```

| Campo            | Tipo    | Descripción                                                                                                                                  |
| ---------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| `apiKey`         | string  | La clave de API de Firecrawl para el equipo de este usuario asociado con el partner                                                          |
| `alreadyExisted` | boolean | `true` si tanto el usuario como el equipo asociado con el partner ya existían. Cuando es `true`, el cupón promocional no vuelve a aplicarse. |

<div id="errors">
  #### Errores
</div>

| Estado | Descripción                                                   |
| ------ | ------------------------------------------------------------- |
| `401`  | No autorizado: la clave de socio es incorrecta o no es válida |
| `500`  | Error interno del servidor: Firecrawl supervisa estos errores |

***

<div id="validate-api-key">
  ### Validar la clave de API
</div>

Valida una clave de API de Firecrawl y devuelve el nombre del equipo asociado y la dirección de correo electrónico del usuario. La clave de API solo se considerará válida si se creó a través de esta integración de partner.

```
POST /partner/v1/api-keys/validate
```

<div id="important-notes">
  #### Notas importantes
</div>

* Las claves de API de Firecrawl no tienen permisos ni fecha de vencimiento.
* Los usuarios pueden eliminar manualmente las claves de API en cualquier momento.
* Las claves de API eliminadas no se conservan como eliminadas de forma lógica. Firecrawl no puede distinguir entre una clave eliminada y una que nunca existió.

<div id="request">
  #### Solicitud
</div>

```bash cURL theme={null}
curl -X POST "https://integrations.firecrawl.dev/partner/v1/api-keys/validate" \
  -H "Authorization: Bearer <partner key>" \
  -H "Content-Type: application/json" \
  -d '{"apiKey": "fc-..."}'
```

**Cuerpo**

| Campo    | Tipo   | Obligatorio | Descripción                         |
| -------- | ------ | ----------- | ----------------------------------- |
| `apiKey` | string | Sí          | La clave de API que se va a validar |

<div id="response">
  #### Respuesta
</div>

**`200 OK`**

```json theme={null}
{
  "teamName": "Example Team",
  "email": "user@example.com"
}
```

| Campo      | Tipo   | Descripción                                                                 |
| ---------- | ------ | --------------------------------------------------------------------------- |
| `teamName` | string | El nombre del equipo asociado a esta clave de API                           |
| `email`    | string | La dirección de correo electrónico del usuario asociada a esta clave de API |

<div id="errors">
  #### Errores
</div>

| Estado | Descripción                                                                                                      |
| ------ | ---------------------------------------------------------------------------------------------------------------- |
| `401`  | No autorizado: la clave de socio es incorrecta o no válida                                                       |
| `404`  | No se puede identificar la clave de API: la clave no existe o no se creó a través de esta integración de partner |
| `500`  | Error interno del servidor: Firecrawl supervisa estos errores                                                    |

***

<div id="rotate-api-key">
  ### Rotar la clave de API
</div>

Elimina una clave de API de Firecrawl existente y crea una nueva para el mismo usuario y equipo.

```
POST /partner/v1/api-keys/rotate
```

<div id="request">
  #### Solicitud
</div>

```bash cURL theme={null}
curl -X POST "https://integrations.firecrawl.dev/partner/v1/api-keys/rotate" \
  -H "Authorization: Bearer <partner key>" \
  -H "Content-Type: application/json" \
  -d '{"apiKey": "fc-..."}'
```

**Cuerpo**

| Campo    | Tipo   | Obligatorio | Descripción                                    |
| -------- | ------ | ----------- | ---------------------------------------------- |
| `apiKey` | string | Sí          | La clave de API que se eliminará y reemplazará |

<div id="response">
  #### Respuesta
</div>

**`200 OK`**

```json theme={null}
{
  "apiKey": "fc-..."
}
```

| Campo    | Tipo   | Descripción                   |
| -------- | ------ | ----------------------------- |
| `apiKey` | string | La clave de API recién creada |

<div id="errors">
  #### Errores
</div>

| Estado | Descripción                                                                                                      |
| ------ | ---------------------------------------------------------------------------------------------------------------- |
| `401`  | No autorizado: la clave de socio es incorrecta o no válida                                                       |
| `404`  | No se puede identificar la clave de API: la clave no existe o no se creó a través de esta integración de partner |
| `500`  | Error interno del servidor: Firecrawl supervisa estos errores                                                    |

***

<div id="become-a-partner">
  ## Conviértete en socio
</div>

El programa para socios de Firecrawl está disponible para plataformas aprobadas. Si te interesa integrar Firecrawl en tu plataforma y ofrecer créditos a tus usuarios, contáctanos en [partnerships@firecrawl.dev](mailto:partnerships@firecrawl.dev) para obtener más información y solicitar una clave de API para socios.