Add multiple tokens to user

Adds multiple tokens to a user and overwrites matching existing tokens.

URL: https://api.courier.com/users/:user_id/tokens

Method: PUT

PATH PARAMS

user_idstringrequired

The user's ID. This can be any uniquely identifiable string.

RESPONSES:

status: 204 OK

status: 400 Bad Request

messagestring

A message describing the error that occurred.

typestring

[invalid_request_error] The type of error that occurred.

Request Example

cURL

curl --request PUT \
     --url https://api.courier.com/users/user-1234/tokens \
     --header 'Accept: application/json' \
     --header 'Content-Type: application/json' \
     --data '
[
  {
    "token": "ABW7HO9Y7XAQXZ7Y",
    "provider_key": "firebase-fcm",
    "device": {
      "app_id": "com.example.app",
      "ad_id": "1234567890",
      "device_id": "1234567890",
      "platform": "android",
      "manufacturer": "Samsung",
      "model": "SM-G930F"
    },
    "tracking": {
      "os_version": "9",
      "ip": "1.2.3.4",
      "lat": "1.2",
      "long": "3.4"
    },
    "expiry_date": "2030-01-01T00:00:00.000Z"
  }
]
'

Node.js

// Dependencies to install:
// $ npm install node-fetch --save

const fetch = require('node-fetch');

const options = {
  method: 'PUT',
  headers: {
    Accept: 'application/json',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify([
    {
      "token": "ABW7HO9Y7XAQXZ7Y",
      "provider_key": "firebase-fcm",
      "device": {
        "app_id": "com.example.app",
        "ad_id": "1234567890",
        "device_id": "1234567890",
        "platform": "android",
        "manufacturer": "Samsung",
        "model": "SM-G930F"
      },
      "tracking": {
        "os_version": "9",
        "ip": "1.2.3.4",
        "lat": "1.2",
        "long": "3.4"
      },
      "expiry_date": "2030-01-01T00:00:00.000Z"
    }
  ])
};

fetch('https://api.courier.com/users/user-1234/tokens', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

Ruby

require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://api.courier.com/users/user-1234/tokens")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Accept"] = 'application/json'
request["Content-Type"] = 'application/json'
request.body = "[{\"token\":\"ABW7HO9Y7XAQXZ7Y\",\"provider_key\":\"firebase-fcm\",\"device\":{\"app_id\":\"com.example.app\",\"ad_id\":\"1234567890\",\"device_id\":\"1234567890\",\"platform\":\"android\",\"manufacturer\":\"Samsung\",\"model\":\"SM-G930F\"},\"tracking\":{\"os_version\":\"9\",\"ip\":\"1.2.3.4\",\"lat\":\"1.2\",\"long\":\"3.4\"},\"expiry_date\":\"2030-01-01T00:00:00.000Z\"}]"

response = http.request(request)
puts response.read_body

Python

# Dependencies to install:
# $ python -m pip install requests

import requests

url = "https://api.courier.com/users/user-1234/tokens"

payload = [
  {
    "token": "ABW7HO9Y7XAQXZ7Y",
    "provider_key": "firebase-fcm",
    "device": {
      "app_id": "com.example.app",
      "ad_id": "1234567890",
      "device_id": "1234567890",
      "platform": "android",
      "manufacturer": "Samsung",
      "model": "SM-G930F"
    },
    "tracking": {
      "os_version": "9",
      "ip": "1.2.3.4",
      "lat": "1.2",
      "long": "3.4"
    },
    "expiry_date": "2030-01-01T00:00:00.000Z"
  }
]
headers = {
  "Accept": "application/json",
  "Content-Type": "application/json"
}

response = requests.request("PUT", url, json=payload, headers=headers)

print(response.text)

Go

package main

import (
  "fmt"
  "strings"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://api.courier.com/users/user-1234/tokens"

  payload := strings.NewReader("[{\"token\":\"ABW7HO9Y7XAQXZ7Y\",\"provider_key\":\"firebase-fcm\",\"device\":{\"app_id\":\"com.example.app\",\"ad_id\":\"1234567890\",\"device_id\":\"1234567890\",\"platform\":\"android\",\"manufacturer\":\"Samsung\",\"model\":\"SM-G930F\"},\"tracking\":{\"os_version\":\"9\",\"ip\":\"1.2.3.4\",\"lat\":\"1.2\",\"long\":\"3.4\"},\"expiry_date\":\"2030-01-01T00:00:00.000Z\"}]")

  req, _ := http.NewRequest("PUT", url, payload)

  req.Header.Add("Accept", "application/json")
  req.Header.Add("Content-Type", "application/json")

  res, _ := http.DefaultClient.Do(req)

  defer res.Body.Close()
  body, _ := ioutil.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))

}

PHP

<?php
// Dependencies to install:
// $ composer require guzzlehttp/guzzle

require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('PUT', 'https://api.courier.com/users/user-1234/tokens', [
  'body' => '[{"token":"ABW7HO9Y7XAQXZ7Y","provider_key":"firebase-fcm","device":{"app_id":"com.example.app","ad_id":"1234567890","device_id":"1234567890","platform":"android","manufacturer":"Samsung","model":"SM-G930F"},"tracking":{"os_version":"9","ip":"1.2.3.4","lat":"1.2","long":"3.4"},"expiry_date":"2030-01-01T00:00:00.000Z"}]',
  'headers' => [
    'Accept' => 'application/json',
    'Content-Type' => 'application/json',
  ],
]);

echo $response->getBody();

Responses Example

Empty

{
  "message": "Error Message",
  "type": "invalid_request_error"
}

Examples

• URL: /users/user-1234/tokens
• Method: PUT
• Body:

{
  "tokens": [
    {
      "token": "ads23fghsdfgsd32",
      "provider_key": "apn",
      "properties": {
        "is_person": true
      },
      "device": {
        "app_id": "com.my.app",
        "platform": "iOS",
        "model": "iPhone 13"
      }
    },
    {
      "token": "b2345dfgdgnwa",
      "provider_key": "apn",
      "tracking": {
        "ip": "127.0.0.1",
        "lat": "0.0",
        "long": "123"
      }
    },
    {
      "token": "c32432fsdfdsdsfscxzcz",
      "provider_key": "firebase-fcm",
      "device": {
        "device_id": "ipad",
        "platform": "ipadOS",
        "model": "iPad mini"
      }
    }
  ]
}