# Realizar solicitudes

La forma más fácil de empezar es enviar una consulta simple sin opciones personalizadas. Añadiremos todos los encabezados estándar de nuestro lado, elegiremos el proxy más rápido y te entregaremos el cuerpo de la respuesta.

```bash
curl -k -x https://unblock.oxylabs.io:60000 \
-U 'USERNAME:PASSWORD' \
'https://ip.oxylabs.io/location'
```

{% hint style="info" %}
Si observas tasas de éxito bajas o recuperas contenido vacío, intenta añadir un `"x-oxylabs-render: html"` encabezado con tu solicitud. Puedes encontrar más información sobre la renderización de JavaScript [**aquí**](https://developers.oxylabs.io/documentation/es/soluciones-avanzadas-de-proxy/web-unblocker/custom-browser-instructions/javascript-rendering).
{% endhint %}

Para utilizar funcionalidades adicionales de [**Web Unblocker**](https://github.com/oxylabs/web-unblocker), como configurar la ubicación del proxy o reutilizar la misma IP para unas cuantas solicitudes consecutivas, envía encabezados adicionales con la solicitud.

{% hint style="info" %}
Para un desbloqueo óptimo de sitios web, Web Unblocker emplea cookies, encabezados y sesiones predefinidos. Por favor, **abstente de enviar cualquier parámetro personalizado usado comúnmente para el desbloqueo**, ya que pueden interferir con la capacidad de Web Unblocker para obtener datos de calidad.
{% endhint %}

Aquí está la lista completa de funcionalidades y encabezados compatibles:

### Funcionalidades adicionales

| Parámetro                           | Descripción                                                                                                                                                                                                                                                                                                  | Enlace para leer más                                                                                                                                                         |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `X-Oxylabs-Session-Id`              | Si deseas reutilizar la misma IP para varias solicitudes, añade un ID de sesión, que puede ser una cadena aleatoria de caracteres.                                                                                                                                                                           | [**Sesión**](https://developers.oxylabs.io/documentation/es/soluciones-avanzadas-de-proxy/web-unblocker/making-requests/session)                                             |
| `X-Oxylabs-Geo-Location`            | Para usar una dirección IP de una ubicación específica, indica un país o una ciudad, por ejemplo, Alemania. Puedes encontrar los valores de geolocalización compatibles [**aquí**](https://developers.oxylabs.io/documentation/es/soluciones-avanzadas-de-proxy/web-unblocker/making-requests/geo-location). | [**Geolocalización**](https://developers.oxylabs.io/documentation/es/soluciones-avanzadas-de-proxy/web-unblocker/making-requests/geo-location)                               |
| Encabezados                         | Si quieres enviar encabezados personalizados, usa `x-oxylabs-force-headers: 1` encabezado al enviar tu solicitud.                                                                                                                                                                                            | [**Encabezados**](https://developers.oxylabs.io/documentation/es/soluciones-avanzadas-de-proxy/web-unblocker/making-requests/headers)                                        |
| Cookies                             | Puedes añadir tus cookies, por ejemplo, `Cookie: NID=1234567890`, a tus solicitudes.                                                                                                                                                                                                                         | [**Cookies**](https://developers.oxylabs.io/documentation/es/soluciones-avanzadas-de-proxy/web-unblocker/making-requests/headers)                                            |
| `X-Oxylabs-Successful-Status-Codes` | Si tu sitio objetivo devuelve un código de estado no estándar con una respuesta exitosa, puedes enviar el código de estado de la respuesta y nuestro sistema no volverá a intentar la solicitud.                                                                                                             | [**Código de estado personalizado**](https://developers.oxylabs.io/documentation/es/soluciones-avanzadas-de-proxy/web-unblocker/making-requests/custom-status-code)          |
| `X-Oxylabs-Render`                  | Si deseas renderizar JavaScript, usa `html` para obtener un HTML renderizado o `png` para obtener una captura de pantalla de la página.                                                                                                                                                                      | [**Renderizado de JavaScript**](https://developers.oxylabs.io/documentation/es/soluciones-avanzadas-de-proxy/web-unblocker/custom-browser-instructions/javascript-rendering) |

{% hint style="info" %}
Para ejemplos de código más avanzados, consulta las páginas individuales de funcionalidades enlazadas en la tabla de arriba.
{% endhint %}

#### Ejemplos de código

{% tabs %}
{% tab title="cURL" %}

```shell
curl -k -x https://unblock.oxylabs.io:60000 \
-U 'USERNAME:PASSWORD' \
'https://ip.oxylabs.io/headers'
```

{% endtab %}

{% tab title="Python" %}

```python
import requests

# Usa aquí tus credenciales de Web Unblocker.
USERNAME, PASSWORD = 'YOUR_USERNAME', 'YOUR_PASSWORD'

# Define el diccionario de proxy.
proxies = {
  'http': f'http://{USERNAME}:{PASSWORD}@unblock.oxylabs.io:60000',
  'https': f'https://{USERNAME}:{PASSWORD}@unblock.oxylabs.io:60000',
}

response = requests.request(
    'GET',
    'https://ip.oxylabs.io/headers',
    verify=False,  # Ignora el certificado SSL
    proxies=proxies,
)

# Imprime la página de resultados en stdout
print(response.text)

# Guarda el HTML devuelto en el archivo result.html
with open('result.html', 'w') as f:
    f.write(response.text)
```

{% endtab %}

{% tab title="Node.js" %}

```javascript
import fetch from 'node-fetch';
import { HttpsProxyAgent } from 'https-proxy-agent';

const username = 'YOUR_USERNAME';
const password = 'YOUR_PASSWORD';

const agent = new HttpsProxyAgent(
  `https://${username}:${password}@unblock.oxylabs.io:60000`
);

// Ignora el certificado
process.env['NODE_TLS_REJECT_UNAUTHORIZED'] = 0;

const response = await fetch('https://ip.oxylabs.io/headers', {
  method: 'get',
  agent: agent,
});

console.log(await response.text());
```

{% endtab %}

{% tab title="PHP" %}

```php
<?php
$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, 'https://ip.oxylabs.io/headers');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_PROXY, 'https://unblock.oxylabs.io:60000');
curl_setopt($ch, CURLOPT_PROXYUSERPWD, 'YOUR_USERNAME' . ':' . 'YOUR_PASSWORD');
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);

$result = curl_exec($ch);
echo $result;

if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close($ch);
```

{% endtab %}

{% tab title="Golang" %}

```go
package main

import (
	"crypto/tls"
	"fmt"
	"io/ioutil"
	"net/http"
	"net/url"
)

func main() {
	const Username = "YOUR_USERNAME"
	const Password = "YOUR_PASSWORD"

	proxyUrl, _ := url.Parse(
		fmt.Sprintf(
			"https://%s:%s@unblock.oxylabs.io:60000",
			Username,
			Password,
		),
	)
	customTransport := &http.Transport{Proxy: http.ProxyURL(proxyUrl)}

	// Ignora el certificado
	customTransport.TLSClientConfig = &tls.Config{InsecureSkipVerify: true}

	client := &http.Client{Transport: customTransport}
	request, _ := http.NewRequest("GET",
		"https://ip.oxylabs.io/headers",
		nil,
	)

	response, _ := client.Do(request)

	responseText, _ := ioutil.ReadAll(response.Body)
	fmt.Println(string(responseText))
}

```

{% endtab %}

{% tab title="C#" %}

```csharp
using System;
using System.Net;
using System.Net.Http;
using System.Threading.Tasks;

namespace OxyApi
{
    class Program
    {
        static async Task Main(string[] args)
        {
            var webProxy = new WebProxy
            {
                Address = new Uri("https://unblock.oxylabs.io:60000"),
                BypassProxyOnLocal = false,
                UseDefaultCredentials = false,

                Credentials = new NetworkCredential(
                userName: "YOUR_USERNAME",
                password: "YOUR_PASSWORD"
                )
            };

            var httpClientHandler = new HttpClientHandler
            {
                Proxy = webProxy,
            };

            // Ignora el certificado
            httpClientHandler.ClientCertificateOptions = ClientCertificateOption.Manual;
            httpClientHandler.ServerCertificateCustomValidationCallback =
                (httpRequestMessage, cert, cetChain, policyErrors) =>
                {
                    return true;
                };


            var client = new HttpClient(handler: httpClientHandler, disposeHandler: true);

            Uri baseUri = new Uri("https://ip.oxylabs.io/headers");
            client.BaseAddress = baseUri;

            var requestMessage = new HttpRequestMessage(HttpMethod.Get, "");

            var response = await client.SendAsync(requestMessage);
            var contents = await response.Content.ReadAsStringAsync();

            Console.WriteLine(contents);
        }
    }
}
```

{% endtab %}

{% tab title="Java" %}

```java
package org.example;

import org.apache.hc.client5.http.auth.AuthScope;
import org.apache.hc.client5.http.auth.CredentialsProvider;
import org.apache.hc.client5.http.classic.methods.HttpGet;
import org.apache.hc.client5.http.config.RequestConfig;
import org.apache.hc.client5.http.impl.auth.CredentialsProviderBuilder;
import org.apache.hc.client5.http.impl.classic.CloseableHttpClient;
import org.apache.hc.client5.http.impl.classic.HttpClients;
import org.apache.hc.client5.http.impl.io.PoolingHttpClientConnectionManagerBuilder;
import org.apache.hc.client5.http.ssl.NoopHostnameVerifier;
import org.apache.hc.client5.http.ssl.SSLConnectionSocketFactoryBuilder;
import org.apache.hc.client5.http.ssl.TrustAllStrategy;
import org.apache.hc.core5.http.HttpHost;
import org.apache.hc.core5.http.io.entity.EntityUtils;
import org.apache.hc.core5.http.message.StatusLine;
import org.apache.hc.core5.ssl.SSLContextBuilder;

import java.util.Arrays;
import java.util.Properties;


public class Main {

    public static void main(final String[] args)throws Exception {
        final CredentialsProvider credsProvider = CredentialsProviderBuilder.create()
                .add(new AuthScope("unblock.oxylabs.io", 60000), "USERNAME", "PASSWORD".toCharArray())
                .build();
        final HttpHost target = new HttpHost("https", "ip.oxylabs.io", 443);
        final HttpHost proxy = new HttpHost("https", "unblock.oxylabs.io", 60000);
        try (final CloseableHttpClient httpclient = HttpClients.custom()
                .setDefaultCredentialsProvider(credsProvider)
                .setProxy(proxy)
                // Recomendamos aceptar nuestro certificado en lugar de permitir tráfico inseguro (http)
                .setConnectionManager(PoolingHttpClientConnectionManagerBuilder.create()
                        .setSSLSocketFactory(SSLConnectionSocketFactoryBuilder.create()
                                .setSslContext(SSLContextBuilder.create()
                                        .loadTrustMaterial(TrustAllStrategy.INSTANCE)
                                        .build())
                                .setHostnameVerifier(NoopHostnameVerifier.INSTANCE)
                                .build())
                        .build())
                .build()) {

            final RequestConfig config = RequestConfig.custom()
                    .build();
            final HttpGet request = new HttpGet("/headers");
            request.setConfig(config);

            System.out.println("Executing request " + request.getMethod() + " " + request.getUri() +
                    " via " + proxy + " headers: " + Arrays.toString(request.getHeaders()));

            httpclient.execute(target, request, response -> {
                System.out.println("----------------------------------------");
                System.out.println(request + "->" + new StatusLine(response));
                EntityUtils.consume(response.getEntity());
                return null;
            });
        }
    }
}
```

{% endtab %}
{% endtabs %}