0.1.2 • Published 6 years ago
oxford-dictionaries-api v0.1.2
oxford-dictionaries-api
node module wrapper for Oxford dictionaries api v2
Install
npm install --save oxford-dictionaries-apiUsage
initial
Initialize an instance of the OxfordDictionaries class to use
// need app_id and app_key
const app_id = 'your_appid'
const app_key = 'your_appkey';
let oxford= require('oxford-dictionaries-api');
let oxforddictionaries = new oxford(app_id, app_key);functions
Note: A lot of the key names for the functions' objects are taken from the oxford docs Here. I might not have updated this readme cause I probably would be working on other things. (I think the biggest thing that people would usually use is entries, which should get you the definition of words)
entries({ word_id, source_lang, fields, grammaticalFeatures, lexicalCategory, domains, registers, strictMatch })
function takes in an object with the following:
| Key | Type | Optional | About | Default | Example | 
|---|---|---|---|---|---|
| word_id | String | No | The identifier for an Entry (case-sensitive). | Null | "ace" | 
| source_lang | String | Yes | Language code of the source language in a monolingual dataset. | "en-gb" | "en-gb" | 
| fields | ArrayString | Yes | A comma-separated list of data fields to return for the matched entries | Null | "definitions", "domains" | 
| grammaticalFeatures | ArrayString | Yes | A comma-separated list of grammatical features ids to match on (default: all features). | Null | "Cardinal", "Ordinal" | 
| lexicalCategory | ArrayString | Yes | A comma-separated list of lexical categories ids to match on (default: all categories). | Null | |
| domains | ArrayString | Yes | A comma-separated list of domains ids to match on (default: all domains). | Null | |
| registers | ArrayString | Yes | A comma-separated list of registers ids to match on (default: all registers). | Null | |
| strictMatch | Boolean | Yes | Specifies whether diacritics must match exactly. | False | True | 
Example:
oxforddictionaries.entries({word_id: 'ace'})
  .then((data) => console.log(data))
  .catch((e) => console.log('Error', e));