# Inicio rápido de la API

## ![](/files/8e9238e9e51825baaf6098f528602508f2abe2b5) Descripción general

Esta guía de inicio rápido proporciona la información esencial que necesita para empezar a trabajar con la API de Flosum Cloud Apps. Está diseñada para ayudarle a orientarse rápidamente para que pueda comenzar a realizar solicitudes con confianza.

### APIs disponibles

APIs públicas de Flosum Cloud Apps disponibles actualmente:

<table><thead><tr><th width="160">API</th><th>Descripción</th></tr></thead><tbody><tr><td><a href="/pages/643338c66585c3a73e06fc7567b280d0d07bfae2">Configuración global</a></td><td>Autentica la conexión con su tenant de Flosum Cloud Apps.</td></tr><tr><td><a href="/pages/1f987f82be09ce2df024207b2eff1dd577f16ce7">Copia de seguridad y archivo</a></td><td>Cree, programe, ejecute y administre sus copias de seguridad y archivos.</td></tr></tbody></table>

#### URL base

La tabla siguiente enumera la URL base de cada API. Dado que los tenants de Flosum están alojados regionalmente, utilice la URL base de la región donde está alojado su tenant.

<table><thead><tr><th width="160.3333740234375">API</th><th>Estados Unidos</th><th>Alemania</th><th>Japón</th><th>Australia</th></tr></thead><tbody><tr><td>Configuración global</td><td>global-us.flosum.app</td><td>global-de.flosum.app</td><td>global-jp.flosum.app</td><td>global-au.flosum.app</td></tr><tr><td>Copia de seguridad y archivo</td><td>backup-us.flosum.app</td><td>backup-de.flosum.app</td><td>backup-jp.flosum.app</td><td>backup-au.flosum.app</td></tr></tbody></table>

{% hint style="warning" %}

### Conexiones frente a organizaciones

En la API de Flosum Cloud Apps, las organizaciones de Salesforce conectadas a su tenant se llaman **Conexiones**, mientras que la interfaz de usuario de Flosum Cloud Apps las denomina **Organizaciones**. Ambos términos describen el mismo recurso, por lo que una Organización mostrada en la interfaz de usuario corresponde directamente a una Conexión devuelta por la API. Tenga presente esta equivalencia al comparar acciones de la interfaz con solicitudes o respuestas de la API.
{% endhint %}

## Autenticación

Las APIs de Flosum Cloud Apps admiten autenticación OAuth 2.0 a través de la API de Configuración global. A continuación se indican los pasos básicos necesarios para autenticar la conexión. Este proceso asume que ya está familiarizado con la autenticación OAuth 2.0 utilizando el flujo `authorization_code` .

{% stepper %}
{% step %}

### Crear una aplicación conectada

Para autenticarse con su tenant de Flosum Cloud Apps, debe tener una aplicación conectada en Configuración global. Esta aplicación conectada proporciona los valores de ID de cliente y secreto de cliente utilizados en la autenticación. Para aprender a crear una aplicación conectada para conectar una API, consulte el siguiente artículo.

* [Crear una aplicación conectada para acceso a la API](/global-settings/global-settings-docs-es/seguridad/connected-apps/crear-una-aplicacion-conectada-para-acceso-a-la-api.md)
  {% endstep %}

{% step %}

### Obtener el código de autorización

**Punto de conexión**: [Broken mention](broken://pages/1afa39a43ccb38cf0d8abd26746be2cb5fd327d3#get-api-v1-oauth-authorize)

Abra la URL de autorización en un navegador, inicie sesión en Configuración global y apruebe la aplicación conectada. Después de que el navegador redirija a su URL de devolución de llamada, copie el parámetro de consulta `code` de esa URL.
{% endstep %}

{% step %}

### Intercambiar el código por un token

**Punto de conexión**: [Broken mention](broken://pages/1afa39a43ccb38cf0d8abd26746be2cb5fd327d3#post-api-v1-oauth-token)

Envíe la solicitud usando las claves del cuerpo que se indican a continuación.

<table><thead><tr><th width="199.6666259765625">Clave</th><th>Valor</th></tr></thead><tbody><tr><td><code>grant_type</code></td><td><code>authorization_code</code></td></tr><tr><td><code>code</code></td><td>El <strong>código de autorización</strong> del paso anterior.</td></tr><tr><td><code>redirect_uri</code></td><td>La misma URI de redirección utilizada en el paso anterior.</td></tr><tr><td><code>client_id</code></td><td>Su <code>ID de cliente</code></td></tr><tr><td><code>client_secret</code></td><td>Su <code>secreto de cliente</code></td></tr></tbody></table>

Una respuesta `200` exitosa devuelve un `access_token` y un `refresh_token`. Pase el `access_token` en el encabezado `Authorization: Bearer` en llamadas posteriores a la API, y guarde el `refresh_token` para poder obtener un nuevo token de acceso cuando el actual caduque.
{% endstep %}
{% endstepper %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.flosum.com/api/api-es/inicio-rapido-de-la-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.