{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Integration Models & PHP Connector","description":"Official KlickTipp API documentation. Learn how to authenticate, integrate external systems, and build reliable automations using the KlickTipp API.","lang":"en-US","siteUrl":"https://developers.klicktipp.com","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"integration-models--php-connector","__idx":0},"children":["Integration Models & PHP Connector"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This page helps you decide how to integrate with KlickTipp and whether using the optional PHP Connector makes sense for your use case."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Quick link for PHP developers:"," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://packagist.org/packages/klicktipp/php-connector"},"children":["PHP Connector on Packagist"]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"integration-models-at-a-glance","__idx":1},"children":["Integration Models at a Glance"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["KlickTipp offers two technical integration models:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Direct API integration"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the KlickTipp APIs directly via HTTP requests. This is the recommended and most flexible approach."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["PHP Connector (optional)"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A helper library that simplifies common tasks for PHP-based projects. It does not add functionality beyond the API."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"recommended-direct-api-integration","__idx":2},"children":["Recommended: Direct API Integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Direct integration with the KlickTipp APIs is the recommended approach for most use cases."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this approach if:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You need full control over requests and responses"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You are building a long-term or complex integration"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You are working outside of PHP"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You want to implement your own error handling and retries"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Avoid this approach only if:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You want a very quick PHP-only prototype"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You explicitly prefer a higher-level abstraction"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"optional-php-connector","__idx":3},"children":["Optional: PHP Connector"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The PHP Connector is a convenience layer for PHP developers."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the PHP Connector if:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Your project is PHP-based"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You want to reduce boilerplate code"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You are building internal tools or prototypes"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Do not use the PHP Connector if:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You require fine-grained request control"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You plan to support multiple programming languages"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You want to tightly couple business logic to API behavior"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All business logic, validation rules, and automation behavior remain entirely within KlickTipp.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"The Connector does not alter this behavior."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Conceptual structure:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["PHP Application"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["PHP Connector (optional)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["KlickTipp API"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["KlickTipp Platform"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For technical details such as available versions, dependencies, and installation instructions, refer to the package listing on Packagist:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"span","attributes":{"className":"link-arrow"},"children":["→"]}," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://packagist.org/packages/klicktipp/php-connector"},"children":["PHP Connector Reference"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"summary","__idx":4},"children":["Summary"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["KlickTipp API"]}," is the authoritative integration interface and should be the primary choice for all implementations.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["PHP Connector"]}," is entirely optional and exists only to simplify common tasks in PHP-based projects."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you need maximum control, long-term stability, or are working outside of PHP, use the API directly."]}]},"headings":[{"value":"Integration Models & PHP Connector","id":"integration-models--php-connector","depth":1},{"value":"Integration Models at a Glance","id":"integration-models-at-a-glance","depth":2},{"value":"Recommended: Direct API Integration","id":"recommended-direct-api-integration","depth":2},{"value":"Optional: PHP Connector","id":"optional-php-connector","depth":2},{"value":"Summary","id":"summary","depth":2}],"frontmatter":{"seo":{"title":"Integration Models & PHP Connector"}},"lastModified":"2026-05-13T16:23:21.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/integration-models","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}