@abcnews/capi-fetch

Grab a Core Media document object from the Preview / Live Content API, based on the current execution domain

Usage no npm install needed!

<script type="module">
  import abcnewsCapiFetch from 'https://cdn.skypack.dev/@abcnews/capi-fetch';
</script>

README

@abcnews/capi-fetch

Grab a Core Media document object from the Preview / Live Content API, based on the current execution domain

$ npm i @abcnews/capi-fetch

Usage

import capiFetch from '@abcnews/capi-fetch';

capiFetch(10736062, (err, doc) => {
  if (!err) {
    console.log(doc);
    // > {executionTime: "367 ms", id: 10736062, docType: "Article", ...}
  }
});

If your project's JS is currently executing in a page on nucwed.aus.aunty.abc.net.au, requests will be made to Preview CAPI (http://nucwed.aus.aunty.abc.net.au/api/v2/*), otherwise they'll be made to Live CAPI (https://content-gateway.abc-prod.net.au/api/v2/*).

If you want to direct a single request to Live CAPI, regardless of the current execution domain, pass true as a 3rd argument to capiFetch.

API

declare function capiFetch(
  cmid: string | number,
  done: (err?: ProgressEvent | Error, doc?: Object) => void,
  forceLive?: boolean,
  forcePreview?: boolean
): void;

Developing

To run the /example project, you need to pretend your local machine is www.abc.net.au to work around cross-domain request limitations on the Content APIs...

  1. Add this to your hosts file:
127.0.0.1 mock.www.abc.net.au
127.0.0.1 mock.nucwed.aus.aunty.abc.net.au
  1. Start the development server: $ npm start
  2. Open mock.nucwed.aus.aunty.abc.net.au:8080 or mock.www.abc.net.au:8080
  3. Restore your hosts file when you're finished

The best way to check that the Preview / Live switching works is to use this module inside a project hosted on *.abc.net.au.

For testing purposes, you can direct all requests to Live CAPI by appending ?prod=1 to your current page URL.

Authors