Skill UI

A guide to building production-grade, fault-tolerant integrations with Notion. Learn industry best practices for handling API failures, including exponential backoff retries, implementing circuit breakers to prevent cascade failures, utilizing offline caching for graceful degradation, and setting up health checks. Essential for maintaining high system uptime when interacting with the Notion API.

This guide covers essential security protocols for integrating with the Notion API. Learn how to manage integration tokens securely, implement OAuth2 flows, and enforce the principle of least privilege by separating read/write capabilities. It is crucial for developers building robust, secure Notion-powered applications.

A comprehensive, step-by-step guide for managing Notion API integrations. Learn how to upgrade both the Node.js (@notionhq/client) and Python (notion-client) SDKs, handle major version breaking changes, and properly manage API version pinning (e.g., 2022-06-28) to ensure stable, production-ready applications.

This skill provides comprehensive strategies for testing OneNote integrations within CI/CD pipelines. It supports mock-only PR checks using MSW for zero-dependency testing, and robust live integration tests for nightly builds using Azure AD credentials. Ideal for automating quality assurance when connecting OneNote features via the Graph API.

This comprehensive guide serves as a complete error decoder for the OneNote Graph API. It analyzes major HTTP status codes (400, 403, 404, 429, 500, 502, 507) and provides root cause analysis, diagnostic steps, and code fixes for common issues. It specifically addresses critical failure modes like deprecated authentication methods and silent 200 OK failures, helping developers debug complex API integrations in production.

This skill provides comprehensive strategies to optimize resource usage and mitigate rate limits when integrating with the OneNote Graph API. It focuses on reducing the operational 'cost' of making API calls by implementing metadata caching (TTL), utilizing JSON batch requests, and performing delta synchronization instead of full list fetches. Essential for high-volume, stable OneNote enterprise integrations.

Provides a comprehensive, production-ready deployment solution for OneNote integrations in containerized environments. This skill addresses critical issues like MSAL token persistence (supporting both file and Redis caches), implementing deep health/readiness checks that validate actual Graph API connectivity, and managing graceful shutdowns. Ideal for containerizing OneNote services for robust, scalable production use with Docker and Kubernetes.

This skill establishes a local development loop for OneNote integrations. It uses Mock Service Workers (MSW) to intercept calls to the Microsoft Graph API, providing realistic, fixture-based responses (e.g., Notebooks, Sections, Pages). This allows developers to rapidly build and test OneNote features without needing live Azure credentials or worrying about rate limit restrictions during development cycles.

A comprehensive go/no-go checklist for deploying OneNote integrations using the Microsoft Graph API. It covers critical production failure points, including advanced authentication resilience (token caching, silent renewal), rate limit handling (exponential backoff, tenant-level tracking), and explicit error code management for robust deployment. Essential for launch reviews.

This skill provides advanced rate limit handling for the OneNote Graph API. It implements a token bucket algorithm and queue-based throttling mechanism to prevent hitting rate limits (429 errors). It correctly parses the 'Retry-After' header and manages both per-user and per-tenant usage quotas, ensuring stable, high-throughput integrations.

A comprehensive guide detailing the reference architecture for connecting to OneNote via the Microsoft Graph API. It covers the distinct API paths, permission models, and object hierarchies for personal (OneDrive), SharePoint, and Microsoft 365 Group notebooks, ensuring seamless design for multi-tenant, enterprise-level integrations.

This skill provides robust, production-grade patterns for interacting with the OneNote Graph API. It addresses critical issues encountered in real-world applications, such as rate limiting (429 errors), transient server failures (502/503), and silent file upload failures. It includes retry decorators, batch request strategies, and proactive rate limit tracking mechanisms for both TypeScript and Python, ensuring highly reliable integrations.