# URLs base

A Ripple disponibiliza APIs RESTful para integrar, gerenciar e interagir com os produtos e serviços da Ripple. Para usar essas APIs, você precisa usar a URL base correta. A URL base faz parte de uma URL REST bem formada.

Para formar a requisição final da API, acrescente à URL base a versão, o caminho, o recurso e os parâmetros necessários.

Cada ambiente usa uma URL base própria
Para mais informações sobre a URL base correta do ambiente de API com que você interage, consulte [URL base por ambiente de API](#url-base-por-ambiente-de-api).

## Componentes de uma URL base

Uma URL base inclui o protocolo HTTPS, o `[domainPrefix]` e o domínio. O `[domainPrefix]` é o trecho da URL base que varia conforme a API e o ambiente.

Este exemplo usa o ambiente  `uat` com a API do Ripple Payments:

```https
https://{domainPrefix}.{domain}/{apiVersion}/{path}?{parameters}
```

```http
https://api.test.ripple.com/v2/identities
```

A tabela a seguir descreve cada componente de uma requisição de API completa:

| Campo | Valor de exemplo | Descrição |
|  --- | --- | --- |
| **Protocolo** | `https` | A Ripple usa o protocolo HTTPS em todas as APIs. |
| **Prefixo de domínio** | `api.test` | Cada URL base é prefixada por `api`, seguido de um [ambiente de API](#url-base-por-ambiente-de-api) opcional.**Exemplo**: este exemplo usa o ambiente `api.test`. |
| **Domínio** | `ripple.com` | A API do Ripple Payments usa `ripple.com` como domínio. |
| **Versão da API** | `/v2` | A versão mais recente da API do Ripple Payments é `/v2`. |
| **Caminho** | `/identities` | O caminho é acrescentado à URL base para alcançar o endpoint da operação da API.Este exemplo aponta para o endpoint `/v2/identities`. |


## URL base da API do Ripple Payments

A API do Ripple Payments inclui um prefixo de domínio composto por `api.{environment}`.

Observação
O ambiente de produção não tem variável de ambiente.

Você pode usar as APIs do Ripple Payments nos seguintes ambientes:

* **UAT** : parceiros simulados e moeda simulada.
* **Production** : ambiente de produção com parceiros e moeda reais.


## URL base por ambiente de API

Os tokens são exclusivos de cada ambiente
Além das URLs base exclusivas, os tokens de acesso também são exclusivos de cada ambiente. Não deixe de [solicitar o token de acesso](/pt-br/products/payments-direct-2/api-docs/get-started/authentication#solicitar-o-token-de-acesso) do ambiente desejado.

| Ambiente | Prefixo de domínio | Domínio | URL base |
|  --- | --- | --- | --- |
| UAT | `api.test.` | `ripple.com` | `https://api.test.ripple.com/v2` |
| Production | `api.` | `ripple.com` | `https://api.ripple.com/v2` |


**Observação**: os exemplos a seguir usam o ambiente `uat`.

```https
https://{domainPrefix}.{domain}/{path}?{parameters}

# This is the URL format.
```

```https
https://api.test.ripple.com/

# This is the base URL for the UAT environment.
```

```https
https://api.test.ripple.com/v2/identities

# This connects to the UAT environment and requests a list of identities.
```