# Pruebas de API Cross Connect

La API Cross Connect le permite solicitar, gestionar y desinstalar conexiones físicas por cable entre equipos en los centros de datos de Equinix. Esta guía proporciona estrategias de prueba, ejemplos y mejores prácticas para la integración con la [API Cross Connect](https://docs.equinix.com/api-catalog/crossconnectsv2/).

## Resumen

Las conexiones cruzadas son conexiones físicas por cable que utilizan cables coaxiales, de fibra o de cobre que conectan los equipos de los clientes directamente con otros equipos de clientes dentro de los centros de datos Equinix. Dado que las conexiones cruzadas transmiten datos punto a punto, evitan los problemas de latencia y congestión de la Internet pública.

La API Cross Connect v2 proporciona tres puntos finales principales:

| Method | Endpoint                                         | Description                         |
| ------ | ------------------------------------------------ | ----------------------------------- |
| POST   | `/colocations/v2/orders/crossConnects`           | Order new cross connects            |
| PATCH  | `/colocations/v2/orders/crossConnects/{orderId}` | Update existing cross connect order |
| POST   | `/colocations/v2/orders/crossConnects/deinstall` | Deinstall existing cross connects   |

Antes de probar la API Cross Connect, asegúrese de que dispone de:

* Una cuenta de desarrollador de Equinix con permisos de pedido de conexión cruzada
* Credenciales de API válidas (ID de cliente y secreto de cliente)
* Acceso a ubicaciones de centros de datos adecuadas
* Comprensión de [API Authentication](https://docs.equinix.com/es/equinix-api/api-authentication.md)

## Flujo de trabajo de prueba de Cross Connects

Comience por validar su flujo de autenticación con la API Cross Connect:

```
# Test authentication for Cross Connect API (Python example)

import requests



auth_url = "https://api.equinix.com/oauth2/v1/token"

auth_payload = {

    "grant_type": "client_credentials",

    "client_id": "<your_client_id>",

    "client_secret": "<your_client_secret>"

}

response = requests.post(auth_url, data=auth_payload)

data = response.json()



if response.status_code != 200:

    raise Exception(f"Authentication failed: {response.status_code} {data}")



access_token = data.get("access_token")

print("Access token:", access_token)

print("Token timeout:", data.get("token_timeout"))
```

**Prueba básica de pedido Cross-Connect**

Pruebe el escenario más habitual: solicitar una conexión cruzada de fibra monomodo:

```
import requests

import json



# Setup authentication

base_url = "https://api.equinix.com"

auth_url = f"{base_url}/oauth2/v1/token"

auth_payload = {

    "grant_type": "client_credentials",

    "client_id": "YOUR_CLIENT_ID",

    "client_secret": "YOUR_CLIENT_SECRET"

}



auth_response = requests.post(auth_url, data=auth_payload)

token = auth_response.json()["access_token"]



# Prepare request

headers = {

    "Authorization": f"Bearer {token}",

    "Content-Type": "application/json"

}



# Test ordering a basic single mode fiber cross connect

payload = {

    "customerReferenceId": "TEST-CC-001",

    "description": "Test cross connect for API integration",

    "details": [

        {

            "aSide": {

                "connectionService": "SINGLE_MODE_FIBER",

                "mediaType": "SINGLE_MODE_FIBER",

                "protocolType": "10_GIG_ETHERNET",

                "connectorType": "FC",

                "patchPanel": {

                    "id": "CP:0104:1199890"

                }

            },

            "zSide": {

                "patchPanel": {

                    "id": "PP:0104:1190123"

                },

                "circuitId": "TEST-CIRCUIT-001",

                "connectorType": "LC"

            }

        }

    ]

}



response = requests.post(

    f"{base_url}/colocations/v2/orders/crossConnects",

    headers=headers,

    data=json.dumps(payload)

)



# Verify response

assert response.status_code == 201, f"Failed to create order: {response.text}"

order_data = response.json()

order_id = order_data.get("orderId")



print(f"Successfully created Cross Connect order with ID: {order_id}")

print(f"Current status: {order_data.get('status')}")
```

## Mejores prácticas para las pruebas de API Cross Connect

**IDs de paneles de conexión no válidos**

* Asegúrese de que los ID de los paneles de conexiones siguen el formato correcto: `CP:XXXX:XXXXXXX`.
* Verifique la disponibilidad del panel de conexiones en el centro de datos de destino

**Errores de autenticación**

* Compruebe la caducidad del token (normalmente 1 hora)
* Verifique que las credenciales del cliente son correctas
* Garantice la correcta implementación del flujo OAuth2

**Errores de validación**

* Revise los campos obligatorios frente a los opcionales en la especificación API
* Compruebe los tipos de datos y los requisitos de formato
* Validar valores enum para connectionService, mediaType, etc.

**Errores de permiso**

* Verifique que su cuenta tiene permisos para pedidos de conexión cruzada
* Comprobar los permisos de acceso al centro de datos
* Asegúrese de tener acceso a las ubicaciones IBX especificadas

## Documentación relacionada

* [Cross Connect API OpenAPI Specification](https://docs.equinix.com/es/api-catalog/crossconnectsv2.md)
* [General API Testing Guidelines](https://docs.equinix.com/es/equinix-api/testing.md)
* [API Authentication Guide](https://docs.equinix.com/es/equinix-api/api-authentication.md)

## Necesita ayuda

Si encuentra problemas mientras prueba la API Cross Connect:

* Revise las [API FAQ](https://docs.equinix.com/es/equinix-api/api-faqs.md)
* Póngase en contacto con [Equinix Support](https://support.equinix.com) para obtener ayuda