synapsefi-js-api-wrapper
Installation
npm installation synapsefi-ui axios lodash
Motivation
synapsefi-js-api-wrapper
was built to simplify api requests to synapsefi's core public apis.
Table of Contents
-
Users Api Request Examples
-
- with no argument
- search by name or email (query)
- specific page and per page (page, per_page)
- conbining query, page, and per_page
-
- update base doc
- update sub docs
-
- update legal name, login email, password, and phone number
- update cip_tag, public_note
-
- lock user
- delete user
-
Setup
ApiWrapper generates instance of apiWrapper. We decide to name an instance as apiWrapper because all it does is firing api calls. User of this library can declare variable with diffrent naming convention.
import ApiWrapper from 'synapsefi-js-api-wrapper'; // for client
// const ApiWrapper = require('synapsefi-js-api-wrapper'); // for node
const platformUserApiWrapper = new ApiWrapper({
host: 'sandbox or production host(ex: https://uat-api.synapsefi.com)',
client_id: '<clinet id>',
client_secret: '<clinet secret>',
fingerprint: '<fingerprint>',
ip_address: '<user_id> of platform',
oauth_key: '<oauth_key>',
user_id: '<user_id> of platform',
refresh_token: '<refresh_token> of platform',
});
const endUserApiWrapper = new ApiWrapper({
host: platformUserApiWrapper.host,
client_id: platformUserApiWrapper.client_id,
client_secret: platformUserApiWrapper.client_secret,
ip_address: platformUserApiWrapper.ip_address,
user_id: '<user_id> of the end user',
fingerprint: '<finger print when this user is created>',
refresh_token: '<refresh_token> of the end user',
oauth_key: '<oauth_key> of the end user',
});
Users Api Request Examples
Get all client users
(GET_ALL_CLIENT_USERS)
with no argument
platformUserApiWrapper.GET_ALL_CLIENT_USERS().then(({data}) => {
console.log('data: ', data);
});
search by name or email using query
platformUserApiWrapper.GET_ALL_CLIENT_USERS({ query: 'John Doe' }).then(({data}) => {
console.log('data: ', data);
});
specific page and per page (page, per_page)
platformUserApiWrapper
.GET_ALL_CLIENT_USERS({
page: 2,
per_page: 3,
})
.then(({ data }) => {
console.log('data: ', data);
});
conbining query, page, and per_page
platformUserApiWrapper
.GET_ALL_CLIENT_USERS({
query: 'sean@gmail.com',
page: 1,
per_page: 2,
})
.then(({ data }) => {
console.log('data: ', data);
});
Create User
(POST_CREATE_USER)
platformUserApiWrapper
.POST_CREATE_USER({
logins: [{ email: 'email@email.com' }],
phone_numbers: ['123.123.1233'],
legal_names: ['John Doe'],
})
.then(({ data }) => {
console.log('data: ', data);
});
Get User
(GET_USER)
platformUserApiWrapper.GET_USER().then(({ data }) => {
console.log('data: ', data);
});
Add Document
(PATCH_ADD_NEW_DOCUMENTS)
const personalDocuments = [{
email: 'personal@email.com',
phone_number: '1231231233',
ip: '127.0.0.1',
name: 'Personal Name',
alias: 'Test',
entity_type: 'M',
entity_scope: 'Arts & Entertainment',
day: 2,
month: 5,
year: 1989,
address_street: '101 2nd St',
address_city: 'SF',
address_subdivision: 'CA',
address_postal_code: '94105',
address_country_code: 'US',
social_docs: [
{
document_value: 'https://www.facebook.com/validasdf',
document_type: 'FACEBOOK',
},
],
}];
platformUserApiWrapper
.PATCH_ADD_NEW_DOCUMENTS({
documents: personalDocuments,
})
.then(({ data }) => {
console.log('data: ', data);
});
Update Exsiting Document
(PATCH_UPDATE_DOCUMENTS)
update base doc
platformUserApiWrapper
.PATCH_UPDATE_DOCUMENTS([{
documents: {
id: '<initialBaseDocId>',
email: 'updated@gmail.com',
},
}])
.then(({ data }) => {
console.log('data: ', data);
});
update sub docs
platformUserApiWrapper
.PATCH_UPDATE_DOCUMENTS({
documents: [{
id: '<initialBaseDocId>',
social_docs: [
{
id: '<facebookDocId>',
document_value: 'https://www.facebook.com/afterUpdate',
document_type: 'FACEBOOK',
},
],
},
}])
.then(({ data }) => {
console.log('data: ', data);
});
Delete Base Doc
(PATCH_DELETE_BASE_DOC)
platformUserApiWrapper
.PATCH_DELETE_BASE_DOC({ baseDocId: '<document id of base doc>' })
.then(({ data }) => {
console.log('data: ', data);
});
Delete Sub Docs
(PATCH_DELETE_SUB_DOCS)
platformUserApiWrapper
.PATCH_DELETE_SUB_DOCS({
baseDocId: '<base_doc_id>',
socialDocIds: [
'<social_doc_id 1>',
'<social_doc_id 2>',
'fda60784d6375bc44eda...',
'28d9177b22c127d9a51d...',
],
})
.then(({ data }) => {
console.log('data: ', data);
});
Update User
(PATCH_UPDATE_USER)
update legal name, login email, password, and phone number
platformUserApiWrapper
.PATCH_UPDATE_USER({
updateObj: {
legal_name: 'After User',
login: { email: 'after@email.com' },
phone_number: '9879879877',
remove_legal_name: 'Before User',
remove_login: { email: 'before@email.com' },
remove_phone_number: '1231231233',
},
})
.then(({ data }) => {
console.log('data: ', data);
});
update cip_tag
platformUserApiWrapper
.PATCH_UPDATE_USER({
updateObj: {
legal_name: 'After User',
cip_tag: 2,
// public_note: 'Eask just updated public note ~~~',
},
})
.then(({ data }) => {
console.log('data: ', data);
});
If you include public note then cip tag will not be updated (bug ?)
Update User Permission
(PATCH_USER_PERMISSION)
lock user
endUserApiWrapper
.PATCH_USER_PERMISSION({
permission: 'LOCKED',
})
.then(({ data }) => {
console.log('data: ', data);
});
delete user
endUserApiWrapper
.PATCH_USER_PERMISSION({
permission: 'MAKE-IT-GO-AWAY',
})
.then(({ data }) => {
console.log('data: ', data);
});
Oauth Key
platformUserApiWrapper.oauth_key = 'fake oauth key';
console.log('platformUserApiWrapper.oauth_key: ', platformUserApiWrapper.oauth_key); // fake oauth key
platformUserApiWrapper.POST_OAUTH_USER().then(({ data }) => {
console.log('data: ', data);
});
// Calling "POST_OAUTH_USER" set new oauth_key to platformUserApiWrapper.
// platformUserApiWrapper.oauth_key === data.oauth_key
console.log('platformUserApiWrapper.oauth_key: ', platformUserApiWrapper.oauth_key); // data.oauth_key