Unofficial iOS/macOS SDK for the Notion API.

Overview

NotionClient: a Notion SDK for iOS & macOS

Unofficial Notion API SDK for iOS & macOS. This is an alpha version and still work in progress.

TODO

Features:

  • Create new pages in a database
  • Add filters & sorts for database query
  • Make all objects copyable
  • Add Foundation objects for blocks / modifying page contents

Documentation:

  • Add documentation for all methods
  • Add sample project for Objective-C
  • Add sample project for Swift

Support:

  • Add support for macOS
  • Add support for tvOS
  • Add support for watchOS?
  • Add OAuth2 authorization support? (currently not possible due to limitations in redirect URI)

Introduction

NotionClient is a native iOS & macOS SDK for Notion's official API. NotionClient converts all API JSON objects to native Foundation objects. API responses are automatically converted to Foundation objects making it a lot easier to read the data coming from Notion. Those same Foundation objects can then be modified and sent back to the API to update the objects. Several objects also have convenience initializers for the most common use cases, e.g. setting a text property with just 1 string in 1 color.

This way, there is never any need to deal with Notion's complex JSON structure directly.

Requirements

  • iOS 11 or above

Installation

NotionClient does not use any external dependencies.

Manually

  1. Open NotionClient.xcodeproj
  2. Build the NotionClient-iOS scheme
  3. Copy the generated NotionClient.framework file to your project

Using CocoaPods

Add NotionClient to your Podfile and run pod install.

# Podfile
platform :ios, '11.0'

target 'YOUR_TARGET_NAME' do
    # Dynamic frameworks is supported but not required
    use_frameworks!
	
    pod 'NotionClient', '0.0.1'
end

Usage

Objective-C

Import Notion.h in the implementation files (or in a Prefix header):

#import <NotionClient/Notion.h>

Swift

Import Notion.h in the Objective-C Bridging Header:

// Bridging header
#import <NotionClient/Notion.h>

Documentation

Creating a NotionClient

All communication with the Notion API happens using the NotionClient object. To initialize it you'll need a token, see the official Authorization guide for more info.

Swift:

let client = NotionClient.init(token: "NOTION_INTEGRATION_TOKEN")

Objective-C:

NotionClient *client = [NotionClient clientWithToken:@"NOTION_INTEGRATION_TOKEN"];

More documentation coming soon!

License

NotionClient is released under an MIT License. See LICENSE for details.

Owner
David De Bels
David De Bels
👤 Framework to Generate Random Users - An Unofficial Swift SDK for randomuser.me

RandomUserSwift is an easy to use Swift framework that provides the ability to generate random users and their accompanying data for your Swift applic

Wilson Ding 95 Nov 2, 2021
Unofficial Dribbble iOS wrapper allows you to integrate Dribble API into iOS application (Designer, Shot, Comment, User Story, Like, Follow)

DribbbleSDK DribbbleSDK is easy-to-use iOS wrapper for Dribbble SDK. We're working hard to complete the full coverage of available methods and make th

Agilie Team 74 Dec 2, 2020
:octocat: Unofficial GitHub API client in Swift

Github.swift ❤️ Support my apps ❤️ Push Hero - pure Swift native macOS application to test push notifications PastePal - Pasteboard, note and shortcut

Khoa 177 Oct 30, 2021
The Waterwheel Swift SDK provides classes to natively connect iOS, macOS, tvOS, and watchOS applications to Drupal 7 and 8.

Waterwheel Swift SDK for Drupal Waterwheel makes using Drupal as a backend with iOS, macOS, tvOS, or watchOS enjoyable by combining the most used feat

Kyle Browning 413 Jul 22, 2021
An Elegant Spotify Web API Library Written in Swift for iOS and macOS

Written in Swift 4.2 Spartan is a lightweight, elegant, and easy to use Spotify Web API wrapper library for iOS and macOS written in Swift 3. Under th

Dalton Hinterscher 103 Sep 1, 2021
Easy and powerful way to interact with VK API for iOS and macOS

Easy and powerful way to interact with VK API for iOS and macOS. Key features ?? It's not ios-vk-sdk ?? ?? One library for iOS and mac OS ?? ?? Fully

null 258 Oct 21, 2021
Giphy API client for iOS in Objective-C

Giphy-iOS Giphy-iOS is a Giphy API client for iOS in Objective-C. Usage To run the example project, clone the repo, and run pod install from the Examp

alex choi 52 Jul 11, 2019
A Swift wrapper for Foursquare API. iOS and OSX.

Das Quadrat Das Quadrat is Foursquare API wrapper written in Swift. Features Supports iOS and OSX. Covers all API endpoints. Authorization process imp

Constantine Fry 173 Oct 23, 2021
A stable, mature and comprehensive Objective-C library for Twitter REST API 1.1

STTwitter A stable, mature and comprehensive Objective-C library for Twitter REST API 1.1 Like a FOSS version of Twitter Fabric TwitterKit, without th

Nicolas Seriot 1k Nov 10, 2021
Twitter API for Cocoa developers

FHSTwitterEngine Twitter API for Cocoa developers Created by Nathaniel Symer FHSTwitterEngine can: Authenticate using OAuth and/or xAuth. Make a reque

Nathaniel Symer 215 Jul 30, 2020
An easy-to-use Objective-C wrapper for the Uber API (no longer supported)

UberKit UberKit is a simple Objective-C wrapper for the new Uber API . Installation Cocoapods UberKit is available through Cocoapods. To install it, s

Sachin Kesiraju 96 Oct 19, 2019
ObjectiveFlickr, a Flickr API framework for Objective-C

ObjectiveFlickr ObjectiveFlickr is a Flickr API framework designed for Mac and iPhone apps. OAuth Support ObjectiveFlickr now supports Flickr's new OA

Lukhnos Liu 719 Aug 5, 2021
Instagram API client written in Swift

SwiftInstagram is a wrapper for the Instagram API written in Swift. It allows you to authenticate users and request data from Instagram effortlessly.

Ander Goig 580 Nov 15, 2021
An API wrapper for bitFlyer.

SwiftFlyer An API wrapper for bitFlyer that supports all providing API. API Document https://lightning.bitflyer.jp/docs Usage Public API Fetch a marke

Ryo Ishikawa 37 Jul 20, 2021
A Swift library for the Forecast.io Dark Sky API

Requirements To use ForecastIO, all you need is an API key for the Dark Sky API. ForecastIO supports iOS (≥9.0), macOS (≥10.10), watchOS (≥2.0), and t

Satyam Ghodasara 165 Sep 25, 2021
iOS/macOS Cross-platform Ark-Ecosystem Framework in Swift | Powered by Ѧrk.io |

a macOS & iOS Swift Framework for Ark.io. What is ARKKit? ARKKit is wrapper for interacting with the Ark Ecosystem. It is written purely in Swift 4.0,

Simon 18 Jun 7, 2021
The Easiest and Simplest iOS library for Twitter and Facebook. Just Drop in and Use!

EasySocial iOS Library for Twitter and Facebook This library allows your apps to use Twitter and Facebook with minimal understanding of the relevant S

pj 127 Oct 13, 2020
:bird: A Twitter framework for iOS & OS X written in Swift

Getting Started Installation If you're using Xcode 6 and above, Swifter can be installed by simply dragging the Swifter Xcode project into your own pr

Matt Donnelly 2.4k Nov 12, 2021