Wrapper around the kopeechka.store email api written with TypeScript for NodeJS and Browser.
The service provides you with real and unique email addresses to receive messages.
npm
npm install @sadzurami/kopeechka-store
yarn
yarn add @sadzurami/kopeechka-store
CDN
<script src="https://cdn.jsdelivr.net/gh/Sadzurami/kopeechka-store@latest/kopeechka.min.js"></script>
Node.js > 15 or any modern browser
import Kopeechka from '@sadzurami/kopeechka-store'
const kop = new Kopeechka('<personal access token>')
const start = async () => {
const address = await kop.getAddress({ website: 'example.com' })
console.log(address)
//=> [email protected]
}
start()
kop.getBalance().then(console.log)
Method that gives a Promise returning an email address string.
Arguments: options (object
).
Options may contain the following fields:
- website (
string
) - Required. The website for which the address is ordered. - domains (
string
|string[]
) - Optional. Preferred address domains. Default - random temp domains. - filter (
object
) - Optional. Message filtering options.
Filter options may contain the following fields:
- sender (
string
) - Optional. Sender of the message. - subject (
string
) - Optional. The subject of the message.
kop
.getAddress({
website: 'example.org',
domains: ['gmail.com', 'yahoo.com'],
// domains: 'outlook.com,aol.com' - also valid
filter: {
sender: '[email protected]',
subject: 'Please confirm your email'
}
})
.then(console.log)
Method that gives a Promise returning an operation status boolean.
Arguments: options (object
).
Options may contain the following fields:
- website (
string
) - Required. The website for which the address is ordered. - address (
string
) - Optional. Earlier received email address. Default - last ordered address on this instance, if it exists.
kop
.reuseAddress({
website: 'example.org',
address: '[email protected]' // optional
})
.then(console.log)
Method that gives a Promise returning an operation status boolean.
Arguments: id (string
).
- id (
string
) - Optional. Task id. Default - id of last ordered address on this instance, if it exists.
kop.releaseAddress('1434984329').then(console.log)
Method that gives a Promise returning a message string.
Arguments: options (object
).
Options may contain the following fields:
- id (
string
) - Optional. Task id. Default - id of last ordered address on this instance, if it exists. - timeout (
number
) - Optional. Timeout of message waiting in ms. Default - 120000. - delay (
number
) - Optional. Delay between requests in ms. Default - 10000. - full (
boolean
) - Optional. Retrieves the full body of the message in any case. Specifyfalse
to get only the parsed part of the message, this can be useful to save bandwidth. Sometimes the server cannot parse a message, in which case the full message will be returned. It's better to get the full message and parse it on your side. Default - true.
kop
.getMessage({
id: '1434984329',
timeout: 120000,
delay: 10000,
full: false
})
.then(console.log)
Method that gives a Promise returning an array of domain objects.
Shortcut of getPopularDomains and getTempDomains methods with compatibility.
Arguments: options (object
).
Options may contain the following fields:
- website (
string
) - Optional. The website for which domains are available. - temp (
boolean
) - Optional. Retrieves temporary domains resource. Dafault - true. - popular (
boolean
) - Optional. Retrieves popular domains resource. Default - true.
kop
.getDomains({
website: 'example.org',
popular: true,
temp: true
})
.then(console.log)
Method that gives a Promise returning an array of domain objects.
Arguments: website (string
).
- website (
string
) - Optional. The website for which domains are available.
kop.getPopularDomains('example.com').then(console.log)
Method that gives a Promise returning an array of domain strings.
Arguments: website (string
).
- website (
string
) - Optional. The website for which domains are available.
kop.getTempDomains('example.com').then(console.log)
Method that gives a Promise returning an id string.
Arguments: options (object
).
Options may contain the following fields:
- website (
string
) - Required. The website for which the address is ordered. - address (
string
) - Required. Earlier received email address.
kop
.findTaskId({ website: 'example.org', address: '[email protected]' })
.then(console.log)
Method that gives a Promise returning an array of task objects.
Arguments: options (object
).
- website (
string
) - Required. The website for which the address is ordered. - address (
string
) - Optional. Earlier received email address. - comment (
string
) - Optional. Task comment. - limit (
number
) - Optional. The number of returned tasks. Default - 1.
kop
.findTasks({
website: 'example.org',
address: '[email protected]',
comment: 'good',
limit: 1
})
.then(console.log)
If you have any questions, please contact service support.
If you have any suggestions, please contact me via email [email protected].