ApideckUnifySdk

Developer-friendly & type-safe Csharp SDK specifically catered to leverage ApideckUnifySdk API.

Summary

Apideck: The Apideck OpenAPI Spec: SDK Optimized

For more information about the API: Apideck Developer Docs

SDK Installation

NuGet

To add the NuGet package to a .NET project:

dotnet add package ApideckUnifySdk

Locally

To add a reference to a local instance of the SDK in a .NET project:

dotnet add reference src/ApideckUnifySdk/ApideckUnifySdk.csproj

SDK Example Usage

Example

using ApideckUnifySdk;
using ApideckUnifySdk.Models.Components;
using ApideckUnifySdk.Models.Requests;
using System.Collections.Generic;

var sdk = new Apideck(
    apiKey: "<YOUR_BEARER_TOKEN_HERE>",
    consumerId: "test-consumer",
    appId: "dSBdXd2H6Mqwfg0atXHXYcysLJE9qyn1VwBtXHX"
);

AccountingTaxRatesAllRequest req = new AccountingTaxRatesAllRequest() {
    ServiceId = "salesforce",
    Filter = new TaxRatesFilter() {
        Assets = true,
        Equity = true,
        Expenses = true,
        Liabilities = true,
        Revenue = true,
    },
    PassThrough = new Dictionary<string, object>() {
        { "search", "San Francisco" },
    },
    Fields = "id,updated_at",
};

AccountingTaxRatesAllResponse? res = await sdk.Accounting.TaxRates.ListAsync(req);

while(res != null)
{
    // handle items

    res = await res.Next!();
}

Authentication

Per-Client Security Schemes

This SDK supports the following security scheme globally:

Name	Type	Scheme
`ApiKey`	http	HTTP Bearer

To authenticate with the API the ApiKey parameter must be set when initializing the SDK client instance. For example:

using ApideckUnifySdk;
using ApideckUnifySdk.Models.Components;
using ApideckUnifySdk.Models.Requests;
using System.Collections.Generic;

var sdk = new Apideck(
    apiKey: "<YOUR_BEARER_TOKEN_HERE>",
    consumerId: "test-consumer",
    appId: "dSBdXd2H6Mqwfg0atXHXYcysLJE9qyn1VwBtXHX"
);

AccountingTaxRatesAllRequest req = new AccountingTaxRatesAllRequest() {
    ServiceId = "salesforce",
    Filter = new TaxRatesFilter() {
        Assets = true,
        Equity = true,
        Expenses = true,
        Liabilities = true,
        Revenue = true,
    },
    PassThrough = new Dictionary<string, object>() {
        { "search", "San Francisco" },
    },
    Fields = "id,updated_at",
};

AccountingTaxRatesAllResponse? res = await sdk.Accounting.TaxRates.ListAsync(req);

while(res != null)
{
    // handle items

    res = await res.Next!();
}

Available Resources and Operations

Available methods

Accounting

Accounting.AgedDebtors

Get - Get Aged Debtors

Accounting.Attachments

List - List Attachments
Get - Get Attachment
Delete - Delete Attachment
Download - Download Attachment

Accounting.BalanceSheet

Get - Get BalanceSheet

Accounting.BillPayments

List - List Bill Payments
Create - Create Bill Payment
Get - Get Bill Payment
Update - Update Bill Payment
Delete - Delete Bill Payment

Accounting.Bills

List - List Bills
Create - Create Bill
Get - Get Bill
Update - Update Bill
Delete - Delete Bill

Accounting.CompanyInfo

Get - Get company info

Accounting.CreditNotes

List - List Credit Notes
Create - Create Credit Note
Get - Get Credit Note
Update - Update Credit Note
Delete - Delete Credit Note

Accounting.Customers

List - List Customers
Create - Create Customer
Get - Get Customer
Update - Update Customer
Delete - Delete Customer

Accounting.Departments

List - List Departments
Create - Create Department
Get - Get Department
Update - Update Department
Delete - Delete Department

Accounting.Expenses

List - List Expenses
Create - Create Expense
Get - Get Expense
Update - Update Expense
Delete - Delete Expense

Accounting.InvoiceItems

List - List Invoice Items
Create - Create Invoice Item
Get - Get Invoice Item
Update - Update Invoice Item
Delete - Delete Invoice Item

Accounting.Invoices

List - List Invoices
Create - Create Invoice
Get - Get Invoice
Update - Update Invoice
Delete - Delete Invoice

Accounting.JournalEntries

List - List Journal Entries
Create - Create Journal Entry
Get - Get Journal Entry
Update - Update Journal Entry
Delete - Delete Journal Entry

Accounting.LedgerAccounts

List - List Ledger Accounts
Create - Create Ledger Account
Get - Get Ledger Account
Update - Update Ledger Account
Delete - Delete Ledger Account

Accounting.Locations

List - List Locations
Create - Create Location
Get - Get Location
Update - Update Location
Delete - Delete Location

Accounting.Payments

List - List Payments
Create - Create Payment
Get - Get Payment
Update - Update Payment
Delete - Delete Payment

Accounting.ProfitAndLoss

Get - Get Profit and Loss

Accounting.PurchaseOrders

List - List Purchase Orders
Create - Create Purchase Order
Get - Get Purchase Order
Update - Update Purchase Order
Delete - Delete Purchase Order

Accounting.Subsidiaries

List - List Subsidiaries
Create - Create Subsidiary
Get - Get Subsidiary
Update - Update Subsidiary
Delete - Delete Subsidiary

Accounting.Suppliers

List - List Suppliers
Create - Create Supplier
Get - Get Supplier
Update - Update Supplier
Delete - Delete Supplier

Accounting.TaxRates

List - List Tax Rates
Create - Create Tax Rate
Get - Get Tax Rate
Update - Update Tax Rate
Delete - Delete Tax Rate

Accounting.TrackingCategories

List - List Tracking Categories
Create - Create Tracking Category
Get - Get Tracking Category
Update - Update Tracking Category
Delete - Delete Tracking Category

Ats

Ats.Applicants

List - List Applicants
Create - Create Applicant
Get - Get Applicant
Update - Update Applicant
Delete - Delete Applicant

Ats.Applications

List - List Applications
Create - Create Application
Get - Get Application
Update - Update Application
Delete - Delete Application

Ats.Jobs

List - List Jobs
Get - Get Job

Connector

Connector.ApiResourceCoverage

Get - Get API Resource Coverage

Connector.ApiResources

Get - Get API Resource

Connector.Apis

List - List APIs
Get - Get API

Connector.ConnectorDocs

Get - Get Connector Doc content

Connector.ConnectorResources

Get - Get Connector Resource

Connector.Connectors

List - List Connectors
Get - Get Connector

Crm

Crm.Activities

List - List activities
Create - Create activity
Get - Get activity
Update - Update activity
Delete - Delete activity

Crm.Companies

List - List companies
Create - Create company
Get - Get company
Update - Update company
Delete - Delete company

Crm.Contacts

List - List contacts
Create - Create contact
Get - Get contact
Update - Update contact
Delete - Delete contact

Crm.Leads

List - List leads
Create - Create lead
Get - Get lead
Update - Update lead
Delete - Delete lead

Crm.Notes

List - List notes
Create - Create note
Get - Get note
Update - Update note
Delete - Delete note

Crm.Opportunities

List - List opportunities
Create - Create opportunity
Get - Get opportunity
Update - Update opportunity
Delete - Delete opportunity

Crm.Pipelines

List - List pipelines

Crm.Users

List - List users
Create - Create user
Get - Get user
Update - Update user
Delete - Delete user

Ecommerce

Ecommerce.Customers

List - List Customers
Get - Get Customer

Ecommerce.Orders

List - List Orders
Get - Get Order

Ecommerce.Products

List - List Products
Get - Get Product

Ecommerce.Stores

Get - Get Store

FileStorage

FileStorage.DriveGroups

List - List DriveGroups
Create - Create DriveGroup
Get - Get DriveGroup
Update - Update DriveGroup
Delete - Delete DriveGroup

FileStorage.Drives

List - List Drives
Create - Create Drive
Get - Get Drive
Update - Update Drive
Delete - Delete Drive

FileStorage.Files

List - List Files
Search - Search Files
Get - Get File
Update - Rename or move File
Delete - Delete File
Download - Download File
Export - Export File

FileStorage.Folders

Create - Create Folder
Get - Get Folder
Update - Rename or move Folder
Delete - Delete Folder
Copy - Copy Folder

FileStorage.SharedLinks

List - List SharedLinks
Create - Create Shared Link
Get - Get Shared Link
Update - Update Shared Link
Delete - Delete Shared Link

FileStorage.UploadSessions

Create - Start Upload Session
Get - Get Upload Session
Delete - Abort Upload Session
Finish - Finish Upload Session

Hris

Hris.Companies

List - List Companies
Create - Create Company
Get - Get Company
Update - Update Company
Delete - Delete Company

Hris.Departments

List - List Departments
Create - Create Department
Get - Get Department
Update - Update Department
Delete - Delete Department

Hris.EmployeePayrolls

List - List Employee Payrolls
Get - Get Employee Payroll

Hris.Employees

List - List Employees
Create - Create Employee
Get - Get Employee
Update - Update Employee
Delete - Delete Employee

Hris.EmployeeSchedules

List - List Employee Schedules

Hris.Payrolls

List - List Payroll
Get - Get Payroll

Hris.TimeOffRequests

List - List Time Off Requests
Create - Create Time Off Request
Get - Get Time Off Request
Update - Update Time Off Request
Delete - Delete Time Off Request

IssueTracking

IssueTracking.Collections

List - List Collections
Get - Get Collection

IssueTracking.CollectionTags

List - List Tags

IssueTracking.CollectionTicketComments

List - List Comments
Create - Create Comment
Get - Get Comment
Update - Update Comment
Delete - Delete Comment

IssueTracking.CollectionTickets

List - List Tickets
Create - Create Ticket
Get - Get Ticket
Update - Update Ticket
Delete - Delete Ticket

IssueTracking.CollectionUsers

List - List Users
Get - Get user

Sms

Sms.Messages

List - List Messages
Create - Create Message
Get - Get Message
Update - Update Message
Delete - Delete Message

Vault

Vault.ConnectionCustomMappings

List - List connection custom mappings

Vault.Connections

List - Get all connections
Get - Get connection
Update - Update connection
Delete - Deletes a connection
Imports - Import connection
Token - Authorize Access Token

Vault.ConnectionSettings

List - Get resource settings
Update - Update settings

Vault.ConsumerRequestCounts

List - Consumer request counts

Vault.Consumers

Create - Create consumer
List - Get all consumers
Get - Get consumer
Update - Update consumer
Delete - Delete consumer

Vault.CreateCallback

State - Create Callback State

Vault.CustomFields

List - Get resource custom fields

Vault.CustomMappings

List - List custom mappings

Vault.Logs

List - Get all consumer request logs

Vault.Sessions

Create - Create Session

Vault.ValidateConnection

State - Validate Connection State

Webhook

Webhook.Webhooks

List - List webhook subscriptions
Create - Create webhook subscription
Get - Get webhook subscription
Update - Update webhook subscription
Delete - Delete webhook subscription

Pagination

Some of the endpoints in this SDK support pagination. To use pagination, you make your SDK calls as usual, but the returned response object will have a Next method that can be called to pull down the next group of results. If the return value of Next is null, then there are no more pages to be fetched.

Here's an example of one such pagination call:

using ApideckUnifySdk;
using ApideckUnifySdk.Models.Components;
using ApideckUnifySdk.Models.Requests;
using System.Collections.Generic;

var sdk = new Apideck(
    apiKey: "<YOUR_BEARER_TOKEN_HERE>",
    consumerId: "test-consumer",
    appId: "dSBdXd2H6Mqwfg0atXHXYcysLJE9qyn1VwBtXHX"
);

AccountingTaxRatesAllRequest req = new AccountingTaxRatesAllRequest() {
    ServiceId = "salesforce",
    Filter = new TaxRatesFilter() {
        Assets = true,
        Equity = true,
        Expenses = true,
        Liabilities = true,
        Revenue = true,
    },
    PassThrough = new Dictionary<string, object>() {
        { "search", "San Francisco" },
    },
    Fields = "id,updated_at",
};

AccountingTaxRatesAllResponse? res = await sdk.Accounting.TaxRates.ListAsync(req);

while(res != null)
{
    // handle items

    res = await res.Next!();
}

Retries

Some of the endpoints in this SDK support retries. If you use the SDK without any configuration, it will fall back to the default retry strategy provided by the API. However, the default retry strategy can be overridden on a per-operation basis, or across the entire SDK.

To change the default retry strategy for a single API call, simply pass a RetryConfig to the call:

using ApideckUnifySdk;
using ApideckUnifySdk.Models.Components;
using ApideckUnifySdk.Models.Requests;
using System.Collections.Generic;

var sdk = new Apideck(
    apiKey: "<YOUR_BEARER_TOKEN_HERE>",
    consumerId: "test-consumer",
    appId: "dSBdXd2H6Mqwfg0atXHXYcysLJE9qyn1VwBtXHX"
);

AccountingTaxRatesAllRequest req = new AccountingTaxRatesAllRequest() {
    ServiceId = "salesforce",
    Filter = new TaxRatesFilter() {
        Assets = true,
        Equity = true,
        Expenses = true,
        Liabilities = true,
        Revenue = true,
    },
    PassThrough = new Dictionary<string, object>() {
        { "search", "San Francisco" },
    },
    Fields = "id,updated_at",
};

AccountingTaxRatesAllResponse? res = await sdk.Accounting.TaxRates.ListAsync(
    retryConfig: new RetryConfig(
        strategy: RetryConfig.RetryStrategy.BACKOFF,
        backoff: new BackoffStrategy(
            initialIntervalMs: 1L,
            maxIntervalMs: 50L,
            maxElapsedTimeMs: 100L,
            exponent: 1.1
        ),
        retryConnectionErrors: false
    ),
    request: req
);

while(res != null)
{
    // handle items

    res = await res.Next!();
}

If you'd like to override the default retry strategy for all operations that support retries, you can use the RetryConfig optional parameter when intitializing the SDK:

using ApideckUnifySdk;
using ApideckUnifySdk.Models.Components;
using ApideckUnifySdk.Models.Requests;
using System.Collections.Generic;

var sdk = new Apideck(
    retryConfig: new RetryConfig(
        strategy: RetryConfig.RetryStrategy.BACKOFF,
        backoff: new BackoffStrategy(
            initialIntervalMs: 1L,
            maxIntervalMs: 50L,
            maxElapsedTimeMs: 100L,
            exponent: 1.1
        ),
        retryConnectionErrors: false
    ),
    apiKey: "<YOUR_BEARER_TOKEN_HERE>",
    consumerId: "test-consumer",
    appId: "dSBdXd2H6Mqwfg0atXHXYcysLJE9qyn1VwBtXHX"
);

AccountingTaxRatesAllRequest req = new AccountingTaxRatesAllRequest() {
    ServiceId = "salesforce",
    Filter = new TaxRatesFilter() {
        Assets = true,
        Equity = true,
        Expenses = true,
        Liabilities = true,
        Revenue = true,
    },
    PassThrough = new Dictionary<string, object>() {
        { "search", "San Francisco" },
    },
    Fields = "id,updated_at",
};

AccountingTaxRatesAllResponse? res = await sdk.Accounting.TaxRates.ListAsync(req);

while(res != null)
{
    // handle items

    res = await res.Next!();
}

Error Handling

Handling errors in this SDK should largely match your expectations. All operations return a response object or throw an exception.

By default, an API error will raise a ApideckUnifySdk.Models.Errors.APIException exception, which has the following properties:

Property	Type	Description
`Message`	string	The error message
`Request`	HttpRequestMessage	The HTTP request
`Response`	HttpResponseMessage	The HTTP response

When custom error responses are specified for an operation, the SDK may also throw their associated exceptions. You can refer to respective Errors tables in SDK docs for more details on possible exception types for each operation. For example, the ListAsync method throws the following exceptions:

Error Type	Status Code	Content Type
ApideckUnifySdk.Models.Errors.BadRequestResponse	400	application/json
ApideckUnifySdk.Models.Errors.UnauthorizedResponse	401	application/json
ApideckUnifySdk.Models.Errors.PaymentRequiredResponse	402	application/json
ApideckUnifySdk.Models.Errors.NotFoundResponse	404	application/json
ApideckUnifySdk.Models.Errors.UnprocessableResponse	422	application/json
ApideckUnifySdk.Models.Errors.APIException	4XX, 5XX	/

Example

using ApideckUnifySdk;
using ApideckUnifySdk.Models.Components;
using ApideckUnifySdk.Models.Errors;
using ApideckUnifySdk.Models.Requests;
using System.Collections.Generic;

var sdk = new Apideck(
    apiKey: "<YOUR_BEARER_TOKEN_HERE>",
    consumerId: "test-consumer",
    appId: "dSBdXd2H6Mqwfg0atXHXYcysLJE9qyn1VwBtXHX"
);

try
{
    AccountingTaxRatesAllRequest req = new AccountingTaxRatesAllRequest() {
        ServiceId = "salesforce",
        Filter = new TaxRatesFilter() {
            Assets = true,
            Equity = true,
            Expenses = true,
            Liabilities = true,
            Revenue = true,
        },
        PassThrough = new Dictionary<string, object>() {
            { "search", "San Francisco" },
        },
        Fields = "id,updated_at",
    };

    AccountingTaxRatesAllResponse? res = await sdk.Accounting.TaxRates.ListAsync(req);

    while(res != null)
    {
        // handle items

        res = await res.Next!();
    }
}
catch (Exception ex)
{
    if (ex is BadRequestResponse)
    {
        // Handle exception data
        throw;
    }
    else if (ex is UnauthorizedResponse)
    {
        // Handle exception data
        throw;
    }
    else if (ex is PaymentRequiredResponse)
    {
        // Handle exception data
        throw;
    }
    else if (ex is NotFoundResponse)
    {
        // Handle exception data
        throw;
    }
    else if (ex is UnprocessableResponse)
    {
        // Handle exception data
        throw;
    }
    else if (ex is ApideckUnifySdk.Models.Errors.APIException)
    {
        // Handle default exception
        throw;
    }
}

Server Selection

Override Server URL Per-Client

The default server can also be overridden globally by passing a URL to the serverUrl: string optional parameter when initializing the SDK client instance. For example:

using ApideckUnifySdk;
using ApideckUnifySdk.Models.Components;
using ApideckUnifySdk.Models.Requests;
using System.Collections.Generic;

var sdk = new Apideck(
    serverUrl: "https://unify.apideck.com",
    apiKey: "<YOUR_BEARER_TOKEN_HERE>",
    consumerId: "test-consumer",
    appId: "dSBdXd2H6Mqwfg0atXHXYcysLJE9qyn1VwBtXHX"
);

AccountingTaxRatesAllRequest req = new AccountingTaxRatesAllRequest() {
    ServiceId = "salesforce",
    Filter = new TaxRatesFilter() {
        Assets = true,
        Equity = true,
        Expenses = true,
        Liabilities = true,
        Revenue = true,
    },
    PassThrough = new Dictionary<string, object>() {
        { "search", "San Francisco" },
    },
    Fields = "id,updated_at",
};

AccountingTaxRatesAllResponse? res = await sdk.Accounting.TaxRates.ListAsync(req);

while(res != null)
{
    // handle items

    res = await res.Next!();
}

Override Server URL Per-Operation

The server URL can also be overridden on a per-operation basis, provided a server list was specified for the operation. For example:

using ApideckUnifySdk;
using ApideckUnifySdk.Models.Components;
using ApideckUnifySdk.Models.Requests;
using System.Collections.Generic;

var sdk = new Apideck(
    apiKey: "<YOUR_BEARER_TOKEN_HERE>",
    consumerId: "test-consumer",
    appId: "dSBdXd2H6Mqwfg0atXHXYcysLJE9qyn1VwBtXHX"
);

FileStorageUploadSessionsAddRequest req = new FileStorageUploadSessionsAddRequest() {
    CreateUploadSessionRequest = new CreateUploadSessionRequest() {
        Name = "Documents",
        ParentFolderId = "1234",
        DriveId = "1234",
        Size = 1810673,
        PassThrough = new List<PassThroughBody>() {
            new PassThroughBody() {
                ServiceId = "<id>",
                ExtendPaths = new List<ExtendPaths>() {
                    new ExtendPaths() {
                        Path = "$.nested.property",
                        Value = new Dictionary<string, object>() {
                            { "TaxClassificationRef", new Dictionary<string, object>() {
                                { "value", "EUC-99990201-V1-00020000" },
                            } },
                        },
                    },
                },
            },
        },
    },
    ServiceId = "salesforce",
};

var res = await sdk.FileStorage.UploadSessions.CreateAsync(
    request: req,
    serverUrl: "https://upload.apideck.com"
);

// handle response

Development

Maturity

This SDK is in beta, and there may be breaking changes between versions without a major version update. Therefore, we recommend pinning usage to a specific package version. This way, you can install the same version each time without breaking changes unless you are intentionally looking for the latest version.

Contributions

While we value open-source contributions to this SDK, this library is generated programmatically. Any manual changes added to internal files will be overwritten on the next generation. We look forward to hearing your feedback. Feel free to open a PR or an issue with a proof of concept and we'll do our best to include it in a future release.

Name		Name	Last commit message	Last commit date
Latest commit History 21 Commits
.github/workflows		.github/workflows
.speakeasy		.speakeasy
docs		docs
src/ApideckUnifySdk		src/ApideckUnifySdk
.gitattributes		.gitattributes
.gitignore		.gitignore
ApideckUnifySdk.sln		ApideckUnifySdk.sln
CONTRIBUTING.md		CONTRIBUTING.md
MIGRATION.md		MIGRATION.md
NUGET.md		NUGET.md
README.md		README.md
RELEASES.md		RELEASES.md
USAGE.md		USAGE.md
global.json		global.json

apideck-libraries/sdk-csharp

Folders and files

Latest commit

History

Repository files navigation

ApideckUnifySdk

Summary

Table of Contents

SDK Installation

NuGet

Locally

SDK Example Usage

Example

Authentication

Per-Client Security Schemes

Available Resources and Operations

Pagination

Retries

Error Handling

Example

Server Selection

Override Server URL Per-Client

Override Server URL Per-Operation

Development

Maturity

Contributions

SDK Created by Speakeasy

About

Resources

Stars

Watchers

Forks

Languages