Passer au contenu principal

Demander l'emplacement d'un colis

Conditions préalables​

  1. Authentifier - envoyez vos identifiants utilisateur, votre identifiant client et votre secret client pour l'authentification OAuth2. Pour obtenir des instructions sur la façon d'appeler l'API OAuth pour valider et authentifier vos identifiants, reportez-vous à authentification API.

  2. Récupérer le numéro de commande de votre envoi entrant - envoyez une GET demande au /colocations/v2/orders/{orderId}terminal pour récupérer un numéro de commande pour un envoi entrant qui a déjà été planifié. Pour planifier un nouvel envoi entrant, envoyez une POST demande au /colocations/v2/orders/shipmentsterminal. Pour planifier un envoi entrant, l'utilisateur doit disposer de Shipments l'autorisation. Vous pouvez sauter cette étape si vous disposez déjà du numéro de commande de l’envoi entrant.

  3. Pour obtenir les détails Smart Hands, vous devez disposer de Smart Handsl'autorisation de commande.

  4. Obtenir les types de Smart Hands - envoyez une GET demande au /v1/orders/smarthands/typesterminal pour obtenir tous les types de commande Smart Hands. Vous pouvez ignorer cette étape si vous connaissez déjà le type de commande Smart Hands.

  5. Obtenir des informations de localisation : envoyez une GET demande au /v1/orders/smarthands/locationspoint final pour récupérer les emplacements IBX disponibles auxquels vous avez accès. Vous pouvez ignorer cette étape si vous connaissez déjà les informations de localisation.

Obtenir l'emplacement d'un colis​

Pour demander l'emplacement de vos colis au IBX, envoyez une POST demande au /v1/orders/smarthands/locatePackageterminal. Dans le corps de la demande, spécifiez les détails de vos packages et besoins dans l'serviceDetailsobjet. Utilisez l'objet facultatif attachmentspour inclure des détails supplémentaires sur un technicien.

note

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

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 obtenir une liste complète des paramètres corporels et des descriptions, reportez-vous à la référence API .

Exemple de réponse :

{
  "OrderNumber": "1-457809872838"
}

La réponse indique que la commande a abouti et renvoie le numéro de commande.

Cette page vous a-t-elle été utile ?