elsayed85 / laravel-notion-api
Laravel Wrapper for the Notion API
Requires
- php: ^7.4|^8.0
- illuminate/support: ^8.0
- spatie/macroable: 1.0.1
Requires (Dev)
- orchestra/testbench: ^6.0
- phpunit/phpunit: ^9.0
This package is auto-updated.
Last update: 2024-10-16 13:11:01 UTC
README
Effortless Notion integrations with Laravel
This package provides a simple and crisp way to access the Notion API endpoints, query data and update existing entries.
Installation
You can install the package via composer:
composer require fiveam-code/laravel-notion-api
Authorization
The Notion API requires an access token and a Notion integration, the Notion documentation explains how this works. It's important to grant access to the integration within your Notion account to enable the API access.
Add your Notion API token to your .env
file:
NOTION_API_TOKEN="$YOUR_ACCESS_TOKEN"
Usage
Head over to the Documentation of this package.
🔥 Code Examples to jumpstart your Notion API Project
Basic Setup
use FiveamCode\LaravelNotionApi\Notion; use Illuminate\Support\Collection; use FiveamCode\LaravelNotionApi\Query\Sorting; use FiveamCode\LaravelNotionApi\Query\Filter; // Setup basic API connection $notion = new Notion(); $notion->v1();
Fetch Page Information
// Returns a specific page $notion->pages()->find($yourPageId);
Query Database
// Queries a specific database and returns a collection of pages (= database entries) $sortings = new Collection(); $filters = new Collection(); $sortings ->add(Sorting::propertySort("Ordered", "ascending")); $sortings ->add(Sorting::timestampSort("created_time", "ascending")); $filters ->add(Filter::textFilter("title", ["contains" => "new"])); // or $filters ->add(Filter::rawFilter("Tags", ["multi_select" => ["contains" => "great"]])); $notion ->database($yourDatabaseId) ->filterBy($filters) // filters are optional ->sortBy($sortings) // sorts are optional ->limit(5) // limit is optional ->query();
Testing
vendor/bin/phpunit tests
Changelog
Please see CHANGELOG for more information what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security
If you discover any security related issues, please email hello@dianaweb.dev instead of using the issue tracker.
Credits
License
The MIT License (MIT). Please see License File for more information.
Laravel Package Boilerplate
This package was generated using the Laravel Package Boilerplate.