Render from a protected URL

Authentication may be required before Doppio can access an HTML page. Here are a few common ways to authenticate a request, including custom headers, cookies, basic authentication, and local storage values.

Using custom headers

const request = require('request');
const options = {
  method: 'POST',
  url: 'https://api.doppio.sh/v1/render/pdf/direct',
  headers: {
    'Authorization': 'Bearer <YOUR API KEY>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    page: {
      pdf: {
        printBackground: true
      },
      goto: {
        url: 'https://www.this-is-a-protected-url.com'
      },
      setExtraHTTPHeaders: {
        'Authorization': '<YOUR OWN TOKEN>',
        'x-something-very-custom': 'a secret token'
      }
    }
  })
};

request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

Using Cookies

const request = require('request');
const options = {
  method: 'POST',
  url: 'https://api.doppio.sh/v1/render/pdf/direct',
  headers: {
    'Authorization': 'Bearer <YOUR API KEY>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    page: {
      pdf: {
        printBackground: true
      },
      goto: {
        url: 'https://www.this-is-a-protected-url.com'
      },
      setCookies: [
        {
          name: 'cookie1',
          value: 'value1',
        },
        {
          name: 'cookie2',
          value: 'value2',
        }
      ]
    }
  })
};

request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

Using basic HTTP authentication

const request = require('request');
const options = {
  method: 'POST',
  url: 'https://api.doppio.sh/v1/render/pdf/direct',
  headers: {
    'Authorization': 'Bearer <YOUR API KEY>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    page: {
      pdf: {
        printBackground: true
      },
      goto: {
        url: 'https://www.this-is-a-protected-url.com'
      },
      authenticate: {
        username: '<username>',
        password: '<password>',
      },
    }
  })
};

request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

Using LocalStorage

const request = require('request');
const options = {
  method: 'POST',
  url: 'https://api.doppio.sh/v1/render/pdf/direct',
  headers: {
    'Authorization': 'Bearer <YOUR API KEY>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    page: {
      pdf: {
        printBackground: true
      },
      goto: {
        url: 'https://www.this-is-a-protected-url.com'
      },
      setLocalStorageItems: [{
        key: 'TOKEN',
        value: 'the secret token value you need to set',
      }],
    }
  })
};

request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});