Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ozmap/ozmap-sdk
Use this SDK to access the OZmap platform and connect it to your systems.
https://github.com/ozmap/ozmap-sdk
nodejs sdk typescript
Last synced: about 2 months ago
JSON representation
Use this SDK to access the OZmap platform and connect it to your systems.
- Host: GitHub
- URL: https://github.com/ozmap/ozmap-sdk
- Owner: ozmap
- License: mit
- Created: 2021-06-13T16:48:15.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-04-22T11:37:51.000Z (9 months ago)
- Last Synced: 2024-04-22T12:53:35.704Z (9 months ago)
- Topics: nodejs, sdk, typescript
- Language: TypeScript
- Homepage:
- Size: 423 KB
- Stars: 0
- Watchers: 0
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# OZmap SDK
OZmap is a solution by devOZ. Based in Florianópolis since 2012, we develop software focused on facilitating the mapping of georeferenced data with the intention of generating intelligent information for strategic decisions.
## What is OZmap SDK?
The OZmap SDK is a tool designed to help developers interact with the OZmap API, providing a streamlined interface for managing georeferenced data. This SDK includes various methods for creating, updating, retrieving, and deleting different models within the OZmap ecosystem, such as projects, cables, boxes, poles, and more.
## Features
- **CRUD Operations**: Easily create, read, update, and delete data.
- **Data Mapping**: Simplifies the interaction with georeferenced data.
- **Batch Operations**: Perform batch updates and retrieves efficiently.
- **Pagination Support**: Handle large datasets with pagination.
- **Filter and Query**: Advanced filtering and querying capabilities.
## Installation
To install the OZmap SDK, use npm:
```bash
npm i --save @ozmap/ozmap-sdk
```
## Usage
### Using login and password
```typescript
import OZMapSDK from '@ozmap/ozmap-sdk';
const sdk = new OZMapSDK('https://api.example.com', { login: 'your-ozmap-login', password: 'your-ozmap-password' });
```
### Using API Key
```typescript
import OZMapSDK from '@ozmap/ozmap-sdk';
const sdk = new OZMapSDK('https://api.example.com', { apiKey: 'your-ozmap-api-key' });
```
## CRUD operations
### Create
```typescript
import OZMapSDK from 'ozmapsdk';
const sdk = new OZMapSDK('ozmapURL', { apiKey: 'yourApiKey' });
const newPopData: CreatePopDTO = {
name: "New Pop",
hierarchyLevel: 1,
popType: "popTypeId",
pole: "poleId",
implanted: true,
};
sdk.pop.create(newPopData).then((pop) => {
console.log('Pop created:', pop);
});
```
### Update
```typescript
import OZMapSDK from 'ozmapsdk';
const sdk = new OZMapSDK('ozmapURL', { apiKey: 'yourApiKey' });
const updatePopData: UpdatePopDTO = {
name: "Updated Pop",
hierarchyLevel: 2,
};
sdk.pop.updateById('popId', updatePopData).then(() => {
console.log('Pop updated');
});
```
### Fetch
```typescript
import OZMapSDK from 'ozmapsdk';
const sdk = new OZMapSDK('ozmapURL', { apiKey: 'yourApiKey' });
sdk.pop.find({ page: 1, limit: 10, filter: [
{
property: "name",
operator: FilterOperator.EQUAL,
value: "Popname",
}]
}).then((pagination) => {
console.log('Pops:', pagination);
});
```
### Fetch by id
```typescript
import OZMapSDK from 'ozmapsdk';
const sdk = new OZMapSDK('ozmapURL', { apiKey: 'yourApiKey' });
sdk.pop.findById('popId').then((pop) => {
console.log('Pop:', pop);
});
```
### Delete
```typescript
import OZMapSDK from 'ozmapsdk';
const sdk = new OZMapSDK('ozmapURL', { apiKey: 'yourApiKey' });
sdk.pop.deleteById('popId').then(() => {
console.log('Pop deleted');
});
```
## Documentation
## Models
### Boxes
- [Base Box](./docs/BASEBOX.md)
- [Box](./docs/BOX.md)
- [Box Template](./docs/BOXTEMPLATE.md)
- [Box Type](./docs/BOXTYPE.md)
### Building
- [Building](./docs/BUILDING.md)
### Cables
- [Cable](./docs/CABLE.md)
- [Cable Type](./docs/CABLETYPE.md)
### Clients
- [FTTH Client](./docs/FTTHCLIENT.md)
### Colors
- [Color](./docs/COLOR.md)
### Connectors
- [Connector](./docs/CONNECTOR.md)
- [Connector Type](./docs/CONNECTORTYPE.md)
- [Network Connectable](./docs/NETWORKCONNECTABLE.md)
- [Network Connector](./docs/NETWORKCONNECTOR.md)
### Cords
- [Cord](./docs/CORD.md)
### Devices
- [DIO](./docs/DIO.md)
- [DIO Type](./docs/DIOTYPE.md)
### Ducts
- [Duct](./docs/DUCT.md)
- [Duct Type](./docs/DUCTTYPE.md)
### Fibers
- [Fiber](./docs/FIBER.md)
- [Fiber Profile](./docs/FIBERPROFILE.md)
### Files
- [File](./docs/FILE.md)
### Fusion
- [Fusion](./docs/FUSION.md)
- [Fusion Type](./docs/FUSIONTYPE.md)
### Horizontal Condominium
- [Horizontal Condominium](./docs/HORIZONTALCONDOMINIUM.md)
### Junction Boxes
- [Junction Box](./docs/JUNCTIONBOX.md)
- [Junction Box Type](./docs/JUNCTIONBOXTYPE.md)
### OLT
- [OLT](./docs/OLT.md)
- [OLT Type](./docs/OLTTYPE.md)
### Passing
- [Passing](./docs/PASSING.md)
### Pendencies
- [Pendency](./docs/PENDENCY.md)
- [Pendency Type](./docs/PENDENCYTYPE.md)
### Points
- [Base Point](./docs/BASEPOINT.md)
- [Point](./docs/POINT.md)
### Poles
- [Pole](./docs/POLE.md)
- [Pole Type](./docs/POLETYPE.md)
### PON
- [PON](./docs/PON.md)
### POP
- [POP](./docs/POP.md)
- [POP Type](./docs/POPTYPE.md)
### POST
- [Post](./docs/POST.md)
### Projects
- [Project](./docs/PROJECT.md)
- [Project Group](./docs/PROJECTGROUP.md)
### Properties
- [Property](./docs/PROPERTY.md)
- [Prospect](./docs/PROSPECT.md)
### Regions
- [Region](./docs/REGION.md)
- [Region Type](./docs/REGIONTYPE.md)
### Roles
- [Role](./docs/ROLE.md)
### Shelves
- [Shelf](./docs/SHELF.md)
- [Shelf Type](./docs/SHELFTYPE.md)
### Slots
- [Slot](./docs/SLOT.md)
### Splitters
- [Splitter](./docs/SPLITTER.md)
- [Splitter Type](./docs/SPLITTERTYPE.md)
### Switches
- [Switch](./docs/SWITCH.md)
- [Switch Type](./docs/SWITCHTYPE.md)
### System
- [System Configuration](./docs/SYSTEMCONFIG.md)
- [Tags](./docs/TAG.md)
- [Users](./docs/USER.md)
## API
For detailed information about the API endpoints and how to use them, please refer to the [OZmap API Documentation](https://ozmap.stoplight.io/docs/ozmap/f20b389eedb19-o-zmap).
## License
This project is licensed under the MIT License.
## Links
- [OZmap Website](https://ozmap.net/)
- [OZmap API Documentation](https://ozmap.stoplight.io/docs/ozmap/f20b389eedb19-o-zmap)