albatros

Integrate the Albatros accounting API via Saloon with typed DTOs and pagination.

3|Updated Feb 13, 2026
One-click install
npx skills add https://github.com/codebar-ag/coding-guidelines --skill albatros
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: albatros
Source: https://github.com/codebar-ag/coding-guidelines/tree/main/resources/boost/skills/albatros
Command: npx skills add https://github.com/codebar-ag/coding-guidelines --skill albatros

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Albatros API integration via Saloon provides a robust, typed wrapper around the Albatros accounting API, enabling consistent API calls, DTO mapping, and cached reference data across the application.

Core Features & Use Cases

  • Saloon-based connector reads the base URL from config('albatros.base_url') and uses token-based Mandant authentication.
  • AlbatrosService wraps all API calls and returns typed DTOs or collections, streamlining consumption.
  • Reference data can be cached to minimize API calls; clearCache() refreshes data as needed.
  • Requests are organized under Resources (Requests/{Resource}/) and support pagination via fetchAllPages().

Quick Start

Configure the AlbatrosConnector with Mandant and base URL, then fetch a list of addresses using the ListAdressenRequest.

Frequently Asked Questions about albatros

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I integrate the Albatros accounting API using Saloon in PHP?

You can integrate the Albatros accounting API using a Saloon-based connector that reads the base URL from config and handles token-based Mandant authentication, returning typed DTOs.

How do I handle paginated API requests for Albatros data?

You can handle paginated API requests by using the built-in fetchAllPages() method, which automatically retrieves all pages of data from Albatros API resources and maps them into typed collections.

What is the best way to cache Albatros API reference data to minimize API calls?

The best way to cache Albatros API reference data is using the provided AlbatrosService, which caches reference data to minimize API calls and provides a clearCache() method to refresh data.

Does Albatros API integration with Saloon support typed DTO mapping?

Yes, Albatros API integration with Saloon supports typed DTO mapping. The AlbatrosService wraps all API calls and automatically maps responses into typed DTOs or collections.

Can I configure a custom base URL for Albatros API requests?

Yes, you can configure a custom base URL for Albatros API requests. The Saloon-based AlbatrosConnector reads the base URL directly from your application's config('albatros.base_url') setting.

How do I set up Mandant authentication for the Albatros API?

To set up Mandant authentication for the Albatros API, you configure the AlbatrosConnector with your token-based credentials, which handles the authentication flow automatically across all requests.