# Pedir la instalación de equipos ![](https://docs.equinix.com/es/assets/images/OrderEquipmentInstallation-cd03635f3bb234dd0b73c67a751046ad.png) ## Requisitos previos[​](#requisitos-previos "Enlace directo a Requisitos previos") 1. Para obtener los detalles de Smart Hands, debe tener `Smart Hands` permiso. 2. Autenticar: Envíe sus credenciales de usuario, ID de cliente y secreto de cliente para la autenticación OAuth2. Consulte [Autenticación de API](https://docs.equinix.com/es/equinix-api/api-authentication.md) para obtener instrucciones sobre cómo llamar al API de OAuth para validar y autenticar sus credenciales. 3. Obtener tipos de Smart Hands - Enviar una `GET` solicitud al [`/v1/orders/smarthands/types`](https://docs.equinix.com/es/api-catalog/smarthandsv1/smarthands/smarthandtypes.md) punto final para obtener todos los tipos de pedido de Smart Hands. Puede omitir este paso si ya conoce el tipo de pedido de Smart Hands. 4. Obtener información de ubicación: Envíe una `GET` solicitud al [`/v1/orders/smarthands/locations`](https://docs.equinix.com/es/api-catalog/smarthandsv1/smarthands/getlocation.md) punto final para recuperar las ubicaciones de IBX disponibles a las que tenga acceso. Puede omitir este paso si ya conoce la información de ubicación. ## Ordenar la instalación de equipos - ejemplo mínimo[​](#ordenar-la-instalación-de-equipos---ejemplo-mínimo "Enlace directo a Ordenar la instalación de equipos - ejemplo mínimo") Para solicitar la instalación de un equipo por parte de un técnico de Equinix IBX, envíe una `POST` solicitud al [`/v1/orders/smarthands/equipmentInstall`](https://docs.equinix.com/es/api-catalog/smarthandsv1/smarthands/handlesmarthandorder.md)punto final. Especifique los requisitos de instalación en el cuerpo de la solicitud. Ejemplo de solicitud cURL: ``` curl -X POST "https://api.equinix.com/v1/orders/smarthands/equipmentInstall" -H "content-type: application/json" -H "authorization: Bearer " -d '{     "ibxLocation": {     "ibx": "AM1",     "cages": [       {         "cage": "AM1:0J:00JD11",         "accountNumber": "126854"       }     ]   },   "serviceDetails": {     "deviceLocation": "DHL tracking no. 1039 5739 92",     "elevationDrawingAttached": false,     "installationPoint": "Front and center.",     "patchDevices": true,     "patchingInfo": "When patching use the next available port, but maintain a symmetrical appearance.",     "powerItOn": true,     "mountHardwareIncluded": true,     "installedEquipmentPhotoRequired": true,     "scopeOfWork": "When installing make sure wires are all labeled."   },   "schedule": {     "scheduleType": "SCHEDULED_MAINTENANCE",     "requestedStartDate": "2019-08-30T22:00:49.776Z",     "requestedCompletionDate": "2019-08-31T22:00:49.776Z"   },   "contacts": [     {         "contactType": "ORDERING",         "userName": "johndoe"     },     {         "contactType": "TECHNICAL",         "userName": "johndoe",         "workPhonePrefToCall": "ANYTIME"     },     {         "contactType": "NOTIFICATION",         "userName": "johndoe"     }   ] }' ``` Respuesta de muestra: ``` { "OrderNumber": "1-190986534844" } ``` La respuesta indica que el pedido se ha realizado correctamente y devuelve el número de pedido. ## Pedir la instalación de equipos - ejemplo ampliado[​](#pedir-la-instalación-de-equipos---ejemplo-ampliado "Enlace directo a Pedir la instalación de equipos - ejemplo ampliado") Para solicitar la instalación de un equipo por parte de un técnico de Equinix IBX, envíe una `POST` solicitud al [`/v1/orders/smarthands/equipmentInstall`](https://docs.equinix.com/es/api-catalog/smarthandsv1/smarthands/handlesmarthandorder.md)punto final. Especifique los requisitos de instalación en el cuerpo de la solicitud. Utilice el `attachments` objeto para incluir detalles adicionales para un técnico. > **Nota** > > Antes de crear un pedido con archivo adjunto, llama al [`Attachments File`](https://docs.equinix.com/es/api-catalog/attachmentsv1/attachments/createattachment.md) punto final. ``` curl -X POST "https://api.equinix.com/v1/orders/smarthands/equipmentInstall" -H "content-type: application/json" -H "authorization: Bearer " -d '{     "ibxLocation": {     "ibx": "AM1",     "cages": [       {         "cage": "AM1:0J:00JD11",         "cabinets": [             "AM1:0J:00JD11:0001"         ],         "accountNumber": "126854"       }     ]   },   "serviceDetails": {     "deviceLocation": "DHL tracking no. 1039 5739 92",     "elevationDrawingAttached": true,     "installationPoint": "Front and center.",     "patchDevices": true,     "patchingInfo": "When patching use the next available port, but maintain a symmetrical appearance.",     "powerItOn": true,     "mountHardwareIncluded": true,     "installedEquipmentPhotoRequired": true,     "scopeOfWork": "When installing make sure wires are all labeled.",     "needSupportFromASubmarineCableStationEngineer": true   },   "attachments": [     {         "id": "fcb4a673-6308-456e-8f83-f745501d60ba",         "name": "Elevation drawing.docx"     }   ],   "schedule": {     "scheduleType": "SCHEDULED_MAINTENANCE",     "requestedStartDate": "2019-08-30T22:00:49.776Z",     "requestedCompletionDate": "2019-08-31T22:00:49.776Z"   },   "customerReferenceNumber": "EQX-PO2019-08-001",   "purchaseOrder": {     "purchaseOrderType": "EXEMPTED",     "attachment": {         "id": "abc1fd2e-345f-67g4-hi89-01jk234l5m6n",         "name": "PurchaseOrderExemptionForm123.docx"     }   },   "contacts": [     {         "contactType": "ORDERING",         "userName": "johndoe"     },     {         "contactType": "TECHNICAL",         "name": "Jane Smith",         "email": "janesmith@corporation.com",         "workPhoneCountryCode": "+44",         "workPhone": "0148211111",         "workPhonePrefToCall": "MY_BUSINESS_HOURS",         "workPhoneTimeZone": "Europe/London",         "mobilePhoneCountryCode": "+44",         "mobilePhone": "0123456789",         "mobilePhonePrefToCall": "MY_BUSINESS_HOURS",         "mobilePhoneTimeZone": "Europe/London"     },     {         "contactType": "NOTIFICATION",         "userName": "johndoe"     },     {         "contactType": "NOTIFICATION",         "userName": "janesmith"     }   ] }' ``` Para obtener una lista completa de los parámetros y descripciones del cuerpo, consulte [la referencia de API](https://docs.equinix.com/es/api-catalog/smarthandsv1/smarthands/handlesmarthandorder.md) .