Thanks to Lisheng Chang @changlisheng for making this photo available freely on Unsplash 🎁
Long story short
It all started as a pet project, I know you understand me.
But rapidly it became more like a developer need: to have something that works as you want it to, something you could share with other developers and be proud of it because, damn, you’ve just became part of an amazing ecosystem called Open Source!
I was finding myself in the need of using the plain JS SDK of Amazon’s Product Advertising API, link here, but it was barely usable, with a lot of conventions, zero explicitness and a whole set of unreadable code.
Maybe it’s just me but in the past year I’ve started to appreciate when you jump into a project and you can understand easily how things get passed around. I needed Typescript.
There was little to no libraries as I expect them to be and finally I came to one conclusion: I needed to do it myself.
And I did it! 👇⭐️
Pigotz / paapi5-typescript-sdk
TypeScript SDK for Product Advertising API 5.0
paapi5-typescript-sdk
Unofficial TypeScript SDK for Product Advertising API 5.0
Installation
In order to install this SDK, you just have to run you well-known npm
or yarn
scripts:
npm i -S paapi5-typescript-sdk
Or
yarn add paapi5-typescript-sdk
And there you go! Enjoy 😎
API
Everything is exported from the SDK: requests' classes, models, utility types, helper and so on..
If you want to import everything
import * as SDK from 'paapi5-typescript-sdk';
And use what you need later
const request = new SDK.SearchItemsRequest(/* ... */);
You can refer to the Amazon Product Advertising API 5.0 for further details about every request
Auth
In order to validate all the requests against the APIs, I've implemented almost from scratch the AWS V4 signing process, creating the SignHelper
class.
This is intended for interal use, but if you want to use it for other purposes, here you can…
I need feedback 🙆♂️
This is a small project but a whole set of TS is involved and needs to be maintained ⚙️
This is my first time being the author of an Open Source repository so any feedback and proposal is welcome 🙏
If you are just lazy, leave a GitHub ⭐️ and a 🦄 here, it would be enough for me!
Thanks for reading!
Top comments (13)
Great, 💥 I am also thinking to make an open-source project.
It would be great if you provide some guidance related to that.
Slap an MIT license on your project and push it to github. The rest is just telling people you know about it and waiting if people find it useful.
There's nothing hard about open source nor anything you need to know: It's just about sharing.
I personally agree with all the other advice!
I just want to add one more little thing: start from the little things like
I hope to have been helpful 🙆♂️
Thank you so much !!
Do you mean some guidance related to Open Source? 🙆♂️ Or specifically to my project?
More about how to make an open-source library? How to think in that way? Sorry, I forgot to mention 😃
If you plan to make a JavaScript open source library, you can use rollup, but if you need a complete guide, then some Google articles may work. Moreover, modern front-end open source libraries generally use TypeScript and Lerna
Thanks 😊
You can also take a look at the monorepo open source library that I recently refactored using lerna, which is a typical rollup+ts+lerna project
github.com/rxliuli/liuli-util
good job 👍
looks to me like you are working for free for Amazon. should't Jeff Bezos make sure the SDK is as easy to use as pissible?
I’m waiting for a message of thanks from him directly 😎
I have a project that i want to work on open source but i'm worried about my intellectual property being stolen as i have not copyrighted the idea. Can someone explain how i can still go ahead with it using people to help me build the project?
I'm sorry but you can't ask for help on a private repository and expect people to help for free :(
Open source is a two way street, if you want help for free you have to offer something for free as well.