Localisation du colis demandée

Préalable

Authentification: soumettez vos identifiants utilisateur, votre identifiant client et votre clé secrète pour l’authentification OAuth2. Consultez la documentation relative à l’authentification API (Authentification API) pour savoir comment appeler l’API OAuth afin de valider et d’authentifier vos identifiants.
Récupérez votre numéro de commande d'expédition entrante - envoyez une requête GET à [/colocations/v2/orders/{orderId}](/api-catalog/ordersv2/#tag/Orders/operation/GET%20Order%Utilisez le point de terminaison 20details pour récupérer le numéro de commande d'un envoi entrant déjà planifié. Pour planifier un nouvel envoi entrant, envoyez une requête POST à l'adresse /colocations/v2/orders/shipments (via l'API /api-catalog/shipmentsv2/#tag/Shipments/operation/Schedule).%20inbound%20 ou%20outbound%Point de terminaison 20shipment). Pour planifier un envoi entrant, l'utilisateur doit disposer de l'autorisation « Expéditions ». Vous pouvez ignorer cette étape si vous avez déjà le numéro de commande de l'envoi entrant.
Pour obtenir les détails de Smart Hands, vous devez disposer de l'autorisation de commande « Smart Hands ».
Obtenir les types de commandes Smart Hands: envoyez une requête GET au point de terminaison /v1/orders/smarthands/types pour obtenir tous les types de commandes Smart Hands. Vous pouvez sauter cette étape si vous connaissez déjà le type de commande Smart Hands.
Récupérer les informations de localisation: envoyez une requête GET au point de terminaison /v1/orders/smarthands/locations pour obtenir les emplacements IBX disponibles auxquels vous avez accès. Vous pouvez sauter cette étape si vous connaissez déjà les informations de localisation.

Obtenir un emplacement de colis

Pour connaître l'emplacement de vos colis à l'IBX, envoyez une requête POST au point de terminaison /v1/orders/smarthands/locatePackage. Précisez les détails de vos colis et vos besoins dans l'objet serviceDetails du corps de la requête. Utilisez l'objet « accessoires » (facultatif) pour fournir des renseignements supplémentaires à un technicien.

remarque

Avant de créer une commande avec pièce jointe, appelez le point de terminaison Attachments File.

curl -X  
POST "https://api.equinix.com/v1/orders/smarthands/locatePackage"  
-H "content-type: application/json"  
-H "authorization: Bearer <token>"  
-d '{  
    "ibxLocation": {  
    "ibx": "AM1",  
    "cages": [  
      {  
        "cage": "AM1:0J:00JD11",  
        "cabinets": [  
            "AM1:0J:00JD11:0001"  
        ],  
        "accountNumber": "126854"  
      }  
    ]  
  },  
  "serviceDetails": {  
    "shipmentOrderNumber": "1-1234567890",  
    "trackingNumber": "All tracking numbers in this shipment order.",  
    "possibleLocation": "Last known location was the loading bay.",  
    "packageDescription": "Multiple DHL boxes.",  
    "scopeOfWork": "Locate and group all boxes together in a fixed location for easy identification and later collection.",  
    "needSupportFromASubmarineCableStationEngineer": true  
  },  
  "attachments": [  
    {  
        "id": "fcb2k8763-2947-456e-8d68-f280753d60ba",  
        "name": "AdditionalShipmentWorkDetails.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"  
    }  
  ]  
}'

Pour une liste complète des paramètres et descriptions du corps, voir la référence de l'API.

Exemple de réponse:

{  
  "OrderNumber": "1-457809872838"  
}

La réponse indique que la commande a été prise en compte et retourne le numéro de commande.

Préalable​

Obtenir un emplacement de colis​

Préalable

Obtenir un emplacement de colis