Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ideal-postcodes/core-axios
Axios backed Ideal Postcodes Javascript Client
https://github.com/ideal-postcodes/core-axios
Last synced: 10 days ago
JSON representation
Axios backed Ideal Postcodes Javascript Client
- Host: GitHub
- URL: https://github.com/ideal-postcodes/core-axios
- Owner: ideal-postcodes
- License: mit
- Created: 2020-01-22T14:14:44.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2024-09-23T14:38:16.000Z (about 2 months ago)
- Last Synced: 2024-10-25T06:11:20.038Z (22 days ago)
- Language: TypeScript
- Size: 1.15 MB
- Stars: 0
- Watchers: 6
- Forks: 0
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
> Axios backed JavaScript client for api.ideal-postcodes.co.uk
[](https://codecov.io/gh/ideal-postcodes/core-axios)
[](https://david-dm.org/ideal-postcodes/core-axios)
[](https://www.npmjs.com/package/@ideal-postcodes/core-axios)
[](https://packagephobia.now.sh/result?p=@ideal-postcodes/core-axios)
[](https://github.com/ideal-postcodes/core-axios/actions)
`@ideal-postcodes/core-axios` is the Axios backed client for api.ideal-postcodes.co.uk. Axios is a promise based HTTP client for the browser and node.js and so is ideal for:
- Frameworks that utilise server side rendering (Angular, Next.js, React, etc)
- Isomorphic code (runs on browser and server)
Our JavaScript client implements a common interface defined at [@ideal-postcodes/core-interface](https://github.com/ideal-postcodes/core-interface).
High level client documentation can be found at [core-interface](https://github.com/ideal-postcodes/core-interface/blob/master/README.md).
In depth client documentation can be found at [core-interface.ideal-postcodes.dev](https://core-interface.ideal-postcodes.dev).
## Links
- [Configuration & Usage](#configuration--usage)
- [Quickstart](#quickstart)
- [Client Documentation](https://github.com/ideal-postcodes/core-interface/blob/master/README.md)
- [In Depth Client Documentation](https://core-interface.ideal-postcodes.dev/#documentation)
- [npm Module](https://www.npmjs.com/package/@ideal-postcodes/core-axios)
- [GitHub Repository](https://github.com/ideal-postcodes/core-axios)
## Other JavaScript Clients
- [Node.js Client Repository](https://github.com/ideal-postcodes/core-node)
- [Browser Client Repository](https://github.com/ideal-postcodes/core-browser)
- [Bundled Browser Client Repository](https://github.com/ideal-postcodes/core-browser-bundled)
## Documentation
### Configuration & Usage
- [Install](#install)
- [Instantiate](#instantiate) and [Use](#use) client
- [Catch Errors](#catch-errors)
#### Install
```bash
npm install @ideal-postcodes/core-axios
```
#### Instantiate
```javascript
import { Client } from "@ideal-postcodes/core-axios"
const client = new Client({ api_key: "iddqd" });
```
[Configuration options](https://core-interface.ideal-postcodes.dev/interfaces/Client.Config.html#baseUrl)
#### Use
```javascript
import { lookupPostcode } from "@ideal-postcodes/core-axios"
const addresses = await lookupPostcode({ client, postcode: "SW1A2AA" });
```
#### Catch Errors
```javascript
import { errors, lookupAddress } from "@ideal-postcodes/core-axios"
try {
await lookupAddress({ client, query: "10 downing street" });
} catch (error) {
if (error instanceof errors.IdpcRequestFailedError) {
// IdpcRequestFailedError indicates a 402 response code
// Possibly the key balance has been depleted
}
}
```
## Test
```bash
npm test
```
## Licence
MIT