# Teste de API Cross Connect A API Cross Connect permite solicitar, gerenciar e desinstalar conexões físicas de cabos entre equipamentos nos data centers da Equinix. Este guia fornece estratégias de teste, exemplos e práticas recomendadas para integração com a [API Cross Connect](https://docs.equinix.com/api-catalog/crossconnectsv2/). ## Visão geral[​](#visão-geral "Link direto para Visão geral") As conexões cruzadas são conexões físicas por meio de cabos coaxiais, de fibra óptica ou de cobre que conectam o equipamento do cliente diretamente a outros equipamentos do cliente dentro dos data centers da Equinix. Como as interconexões transmitem dados ponto a ponto, elas evitam os problemas de latência e congestionamento da internet pública. A API Cross Connect v2 fornece três endpoints principais: | 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 testar a API Cross Connect, certifique-se de ter: * Uma conta de desenvolvedor Equinix com permissões de pedido de conexão cruzada. * Credenciais de API válidas (ID do cliente e segredo do cliente) * Acesso a locais de data center adequados * Compreendendo a [Autenticação de API](https://docs.equinix.com/pt-BR/equinix-api/api-authentication.md) ## Fluxo de trabalho de teste de interconexão[​](#fluxo-de-trabalho-de-teste-de-interconexão "Link direto para Fluxo de trabalho de teste de interconexão") Comece validando seu fluxo de autenticação com a 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": "", "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")) ``` **Teste básico de ordem de interconexão** Teste o cenário mais comum: solicitar uma interconexão 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')}") ``` ## Melhores práticas para testes de API de conexão cruzada[​](#melhores-práticas-para-testes-de-api-de-conexão-cruzada "Link direto para Melhores práticas para testes de API de conexão cruzada") **IDs de painel de conexão inválidos** * Certifique-se de que os IDs do painel de conexão sigam o formato correto: `CP:XXXX:XXXXXXX` * Verificar a disponibilidade do painel de conexões no centro de dados de destino. **Erros de autenticação** * Verifique a expiração do token (normalmente 1 hora). * Verifique se as credenciais do cliente estão corretas. * Garantir a implementação correta do fluxo OAuth2 **Erros de Validação** * Analise os campos obrigatórios e opcionais na especificação da API. * Verifique os tipos de dados e os requisitos de formato. * Validar valores de enumeração para connectionService, mediaType, etc. **Erros de permissão** * Verifique se sua conta possui permissões de pedido entre conexões. * Verificar permissões de acesso ao centro de dados * Certifique-se de ter acesso aos locais IBX especificados. ## Documentação relacionada[​](#documentação-relacionada "Link direto para Documentação relacionada") * [Cross Connect API OpenAPI Specification](https://docs.equinix.com/pt-BR/api-catalog/crossconnectsv2.md) * [General API Testing Guidelines](https://docs.equinix.com/pt-BR/equinix-api/testing.md) * [API Authentication Guide](https://docs.equinix.com/pt-BR/equinix-api/api-authentication.md) ## Precisar de ajuda[​](#precisar-de-ajuda "Link direto para Precisar de ajuda") Se você encontrar problemas ao testar a API Cross Connect: * Consulte as [Perguntas Frequentes da API](https://docs.equinix.com/pt-BR/equinix-api/api-faqs.md) * Contate o [Suporte da Equinix](https://support.equinix.com) para obter assistência.