{"id":51323963,"url":"https://github.com/themesic/perfex-rest-api-examples","last_synced_at":"2026-07-01T16:03:46.870Z","repository":{"id":367246767,"uuid":"1279880930","full_name":"themesic/perfex-rest-api-examples","owner":"themesic","description":"Code examples, Postman collection \u0026 multilingual catalogue for the Perfex CRM REST API - connect Perfex CRM with Zapier, Make, n8n \u0026 third-party apps. cURL, PHP, Python, JS.","archived":false,"fork":false,"pushed_at":"2026-06-25T06:12:04.000Z","size":205,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-25T08:08:34.273Z","etag":null,"topics":["api-documentation","api-examples","crm-api","crm-integration","curl","javascript","make","n8n","perfex","perfex-crm","perfex-crm-api","perfex-crm-modules","php","postman","postman-collection","python","rest-api","webhooks","zapier"],"latest_commit_sha":null,"homepage":"https://themesic.com/product/rest-api-module-for-perfex-crm-connect-your-perfex-crm-with-third-party-applications/","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/themesic.png","metadata":{"files":{"readme":"README.de.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-25T05:00:26.000Z","updated_at":"2026-06-25T06:12:09.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/themesic/perfex-rest-api-examples","commit_stats":null,"previous_names":["themesic/perfex-rest-api-examples"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/themesic/perfex-rest-api-examples","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/themesic%2Fperfex-rest-api-examples","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/themesic%2Fperfex-rest-api-examples/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/themesic%2Fperfex-rest-api-examples/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/themesic%2Fperfex-rest-api-examples/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/themesic","download_url":"https://codeload.github.com/themesic/perfex-rest-api-examples/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/themesic%2Fperfex-rest-api-examples/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35013190,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-01T02:00:05.325Z","response_time":130,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api-documentation","api-examples","crm-api","crm-integration","curl","javascript","make","n8n","perfex","perfex-crm","perfex-crm-api","perfex-crm-modules","php","postman","postman-collection","python","rest-api","webhooks","zapier"],"created_at":"2026-07-01T16:03:46.213Z","updated_at":"2026-07-01T16:03:46.863Z","avatar_url":"https://github.com/themesic.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://themesic.com/product/rest-api-module-for-perfex-crm-connect-your-perfex-crm-with-third-party-applications/\"\u003e\n    \u003cimg src=\"assets/perfex-crm-rest-api.jpg\" alt=\"REST API für Perfex CRM — Perfex CRM mit Zapier, WooCommerce, n8n und Drittanbieter-Apps verbinden\" width=\"100%\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n# Perfex CRM REST API — Beispiele, Postman-Sammlung \u0026 Code-Snippets\n\n🌐 [English](README.md) · [简体中文](README.zh-CN.md) · [Português (BR)](README.pt-BR.md) · [Tiếng Việt](README.vi.md) · [Français](README.fr.md) · **Deutsch**\n\n\u003e Sofort einsatzbereite **Postman-Sammlung**, **Code-Snippets** (cURL, PHP, Python, JavaScript) und ein\n\u003e **Ressourcen-Katalog** für das [REST-API-Modul für Perfex CRM](https://themesic.com/product/rest-api-module-for-perfex-crm-connect-your-perfex-crm-with-third-party-applications/) —\n\u003e der schnellste Weg, **Perfex CRM mit Drittanbieter-Anwendungen zu verbinden**.\n\n[![Postman](https://img.shields.io/badge/Postman-Collection-orange?logo=postman\u0026logoColor=white)](postman/perfex-rest-api.postman_collection.json)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![Perfex CRM](https://img.shields.io/badge/Perfex%20CRM-REST%20API-2c7be5)](https://themesic.com/product/rest-api-module-for-perfex-crm-connect-your-perfex-crm-with-third-party-applications/)\n\nDie **Perfex CRM REST API** ermöglicht das Lesen und Schreiben von Kunden, Leads, Rechnungen, Angeboten,\nProjekten, Aufgaben und mehr über eine saubere HTTP/JSON-Schnittstelle — ideal für **CRM-Integration**,\nAutomatisierung und eigene Anwendungen. Dieses Repository ist die praktische Ergänzung zum Modul\n**[REST API for Perfex CRM](https://themesic.com/product/rest-api-module-for-perfex-crm-connect-your-perfex-crm-with-third-party-applications/)**\nvon **Themesic Interactive**: Copy-\u0026-Paste-Beispiele, eine importierbare Postman-Sammlung und ein\nvollständiger Endpunkt-Katalog.\n\n- 🧩 **Modul herunterladen:** https://themesic.com/product/rest-api-module-for-perfex-crm-connect-your-perfex-crm-with-third-party-applications/\n- 📖 **API-Anleitung / Live-Doku:** https://perfexcrm.themesic.com/apiguide/\n\n---\n\n## Inhalt\n\n| Ordner | Inhalt |\n| --- | --- |\n| [`postman/`](postman/) | Importierbare Postman-**Sammlung** + **Umgebung** (`{{base_url}}`, `{{authtoken}}`) |\n| [`snippets/curl/`](snippets/curl/) | `curl`-Befehle zum Kopieren für die häufigsten Aufrufe |\n| [`snippets/php/`](snippets/php/) | PHP-Beispiele (cURL) |\n| [`snippets/python/`](snippets/python/) | Python-Beispiele (`requests`) |\n| [`snippets/javascript/`](snippets/javascript/) | JavaScript-/Node-Beispiele (`fetch`) |\n| [`docs/`](docs/) | Authentifizierung, Paginierung \u0026 Filterung, Fehler \u0026 Statuscodes |\n\n---\n\n## Schnellstart\n\nJede Anfrage an die Perfex CRM REST API wird mit dem Header **`Authtoken`** authentifiziert. Erstellen Sie\nein Token im Perfex-Adminbereich unter **API → API Management** (nach Aktivierung des\n[REST-API-Moduls](https://themesic.com/product/rest-api-module-for-perfex-crm-connect-your-perfex-crm-with-third-party-applications/))\nund rufen Sie die API unter `https://yourdomain.com/api/...` auf:\n\n```bash\ncurl -H \"authtoken: YOUR_API_TOKEN\" https://yourdomain.com/api/customers\n```\n\nDas liefert die Kundenliste als JSON. Siehe [`docs/authentication.md`](docs/authentication.md) für\nHeader- vs. Query-Parameter-Authentifizierung und [`snippets/`](snippets/) für denselben Aufruf in PHP,\nPython und JavaScript.\n\n### Postman-Sammlung verwenden\n\n1. Postman öffnen → **Import** → [`postman/perfex-rest-api.postman_collection.json`](postman/perfex-rest-api.postman_collection.json) hineinziehen.\n2. Die Umgebung [`postman/perfex-rest-api.postman_environment.json`](postman/perfex-rest-api.postman_environment.json) importieren.\n3. `base_url` auf `https://yourdomain.com/api` und `authtoken` auf Ihr Token setzen.\n4. Eine beliebige Anfrage auswählen und **Send** drücken.\n\n---\n\n## Endpunkt-Katalog\n\nAlle Endpunkte folgen einer RESTful-Konvention: `GET` Liste, `GET /:id` einzeln, `POST` erstellen,\n`PUT /:id` aktualisieren, `DELETE /:id` löschen — unter dem Basis-Pfad `https://yourdomain.com/api`.\n\n| Ressource | Basis-Pfad | Operationen |\n| --- | --- | --- |\n| Customers | `/api/customers` | list, get, create, update, delete |\n| Contacts | `/api/contacts` | list, get, create, update, delete |\n| Leads | `/api/leads` | list, get, create, update, delete |\n| Invoices | `/api/invoices` | list, get, create, update, delete |\n| Estimates | `/api/estimates` | list, get, create, update, delete |\n| Payments | `/api/payments` | list, get, create |\n| Proposals | `/api/proposals` | list, get, create, update, delete |\n| Projects | `/api/projects` | list, get, create, update, delete |\n| Tasks | `/api/tasks` | list, get, create, update, delete |\n| Items | `/api/items` | list, get, create, update, delete |\n| Common (Lookups) | `/api/common` | countries, taxes, currencies, statuses … |\n\n\u003e Die genauen Felder pro Ressource sind in der offiziellen\n\u003e **[API-Anleitung](https://perfexcrm.themesic.com/apiguide/)** dokumentiert.\n\n---\n\n## Beliebte Integrationen \u0026 Anwendungsfälle\n\nDie Perfex CRM REST API wird häufig verwendet, um **Perfex CRM mit Drittanbieter-Anwendungen zu verbinden**:\n\n- **Zapier / Make / n8n** — No-Code-Automatisierung (z. B. einen Perfex-Lead aus einem Webformular erstellen).\n- **Google Sheets / Power Automate** — Kunden, Rechnungen oder Zahlungen mit Tabellen und Dashboards synchronisieren.\n- **Webhooks** — Perfex-Ereignisse (neue Rechnung, neuer Lead) an Slack, Discord oder Ihr Backend senden.\n- **Eigene Apps \u0026 Portale** — eine mobile App oder ein Kundenportal auf Basis Ihrer Perfex-Daten erstellen.\n- **Buchhaltung \u0026 E-Commerce** — Rechnungen und Artikel mit externen Abrechnungs- oder Shop-Plattformen abgleichen.\n\nMöglich gemacht durch das\n[REST-API-Modul für Perfex CRM](https://themesic.com/product/rest-api-module-for-perfex-crm-connect-your-perfex-crm-with-third-party-applications/).\n\n---\n\n## Authentifizierung (Zusammenfassung)\n\n| Methode | Vorgehen |\n| --- | --- |\n| Header (empfohlen) | `Authtoken: YOUR_API_TOKEN` |\n| Query-Parameter | `?authtoken=YOUR_API_TOKEN` (praktisch für schnelle Tests / Webhooks) |\n\nTokens werden unter **API → API Management** erstellt und mit Berechtigungen versehen. Details in\n[`docs/authentication.md`](docs/authentication.md).\n\n---\n\n## FAQ\n\n**Hat Perfex CRM eine REST API?**\nJa. Das [REST-API-Modul für Perfex CRM](https://themesic.com/product/rest-api-module-for-perfex-crm-connect-your-perfex-crm-with-third-party-applications/)\nergänzt eine vollständige RESTful-HTTP/JSON-API für Kunden, Leads, Rechnungen, Angebote, Projekte, Aufgaben und mehr.\n\n**Wie authentifiziere ich mich bei der Perfex CRM API?**\nSenden Sie Ihr Token im HTTP-Header `Authtoken` (oder als `?authtoken=`-Query-Parameter). Siehe\n[`docs/authentication.md`](docs/authentication.md).\n\n**Wie lautet die Basis-URL der Perfex CRM API?**\n`https://yourdomain.com/api` — zum Beispiel `https://yourdomain.com/api/customers`.\n\n**Kann ich Perfex CRM mit Zapier, Make oder n8n verbinden?**\nJa — die REST API funktioniert mit jeder Automatisierungsplattform, die authentifizierte HTTP-Anfragen senden kann.\n\n**Gibt es eine Postman-Sammlung für Perfex CRM?**\nJa — importieren Sie [`postman/perfex-rest-api.postman_collection.json`](postman/perfex-rest-api.postman_collection.json)\nund die Umgebung, setzen Sie `base_url` und `authtoken` und senden Sie Anfragen.\n\n---\n\n## Über / Support\n\nDieses Repository ist eine **Beispielsammlung** zum kommerziellen Modul:\n\n\u003e **[REST API for Perfex CRM — Perfex CRM mit Drittanbieter-Anwendungen verbinden](https://themesic.com/product/rest-api-module-for-perfex-crm-connect-your-perfex-crm-with-third-party-applications/)**\n\u003e von [Themesic Interactive](https://themesic.com).\n\n- 🛒 **Kaufen / mehr erfahren:** https://themesic.com/product/rest-api-module-for-perfex-crm-connect-your-perfex-crm-with-third-party-applications/\n- 📖 **Dokumentation:** https://perfexcrm.themesic.com/apiguide/\n\n## Lizenz\n\nDer Beispielcode in diesem Repository steht unter der [MIT-Lizenz](LICENSE). „Perfex\" ist eine Marke des\njeweiligen Inhabers; das REST-API-Modul ist ein kommerzielles Produkt von Themesic Interactive.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthemesic%2Fperfex-rest-api-examples","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthemesic%2Fperfex-rest-api-examples","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthemesic%2Fperfex-rest-api-examples/lists"}