{"id":26128113,"url":"https://github.com/pdffiller/pdffiller-php-api-client","last_synced_at":"2025-04-09T12:08:21.765Z","repository":{"id":57037173,"uuid":"52603831","full_name":"pdffiller/pdffiller-php-api-client","owner":"pdffiller","description":"The PHP Client Library has been designed for users to quickly and easily implement the PDFfiller REST API. With the PHP Client users can fill documents, send signature requests, download signed documents and more. Sign up for our API here:","archived":false,"fork":false,"pushed_at":"2024-11-01T17:35:12.000Z","size":5476,"stargazers_count":14,"open_issues_count":2,"forks_count":7,"subscribers_count":59,"default_branch":"master","last_synced_at":"2025-04-02T06:51:19.717Z","etag":null,"topics":["integrations","integrations-integration-leads"],"latest_commit_sha":null,"homepage":"https://www.pdffiller.com/en/developers","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/pdffiller.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"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}},"created_at":"2016-02-26T12:45:06.000Z","updated_at":"2024-11-01T17:35:16.000Z","dependencies_parsed_at":"2024-08-01T16:09:06.966Z","dependency_job_id":null,"html_url":"https://github.com/pdffiller/pdffiller-php-api-client","commit_stats":{"total_commits":159,"total_committers":16,"mean_commits":9.9375,"dds":0.4025157232704403,"last_synced_commit":"281532a984d798055e29a4fa6c4587d5138b4bfd"},"previous_names":[],"tags_count":23,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pdffiller%2Fpdffiller-php-api-client","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pdffiller%2Fpdffiller-php-api-client/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pdffiller%2Fpdffiller-php-api-client/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pdffiller%2Fpdffiller-php-api-client/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pdffiller","download_url":"https://codeload.github.com/pdffiller/pdffiller-php-api-client/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248036067,"owners_count":21037092,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["integrations","integrations-integration-leads"],"created_at":"2025-03-10T18:50:37.444Z","updated_at":"2025-04-09T12:08:21.740Z","avatar_url":"https://github.com/pdffiller.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PDFfiller PHP Client\n\n[![Join the chat at https://gitter.im/pdffiller/pdffiller-php-api-client](https://badges.gitter.im/pdffiller/pdffiller-php-api-client.svg)](https://gitter.im/pdffiller/pdffiller-php-api-client?utm_source=badge\u0026utm_medium=badge\u0026utm_campaign=pr-badge\u0026utm_content=badge)\n\n[PDFfiller API](https://api.pdffiller.com)\nYou can sign up for the API [here](https://www.pdffiller.com/en/developers#tab-pricing)\n\n## System Requirements\n* PHP \u003e= 7.0 but the latest stable version of PHP is recommended;\n* `mbstring` extension;\n* `intl` extension;\n\n## Installation\nThe library is available on Packagist and can be installed using Composer. This is done by running the following command on a composer installed box:\n\n```\n$ composer require pdffiller/pdffiller-php-api-client\n```\n\nMost modern frameworks include Composer out of the box. However, please ensure that the following file is included:\n\n````php\n// Include the Composer autoloader\nrequire 'vendor/autoload.php';\n````\n### Troubleshooting\n\nIf you have the following error:\n```\n[RuntimeException]\n Could not load package pdffiller/pdffiller-php-api-client in http://packagi\n st.org: [UnexpectedValueException] Could not parse version constraint ^5.2:\n  Invalid version string \"^5.2\"\n\n\n [UnexpectedValueException]\n Could not parse version constraint ^5.2: Invalid version string \"^5.2\"\n```\nTry running \n```\ncomposer self-update \n```\nAlso you might encounter the following:\n```\nWarning: require_once(../../vendor/autoload.php): failed to open stream: No such file or directory\n```\nThis issue is easily fixed by installing composer dependencies:\n```\ncomposer install\n```\n\n### Quick getting started steps\nInstall required libraries using composer\n```\ncd pdffiller-php-api-client/\ncomposer install\n```\n\nEdit `.env` file in examples directory setting client_id, client_secret, username and password \n(for authorization via `password_grant`)\n```\ncd examples/ \ncp .env.example .env\nvi .env\n```\n\nRun any example\n```\ncd signature_request/\nphp 1_get_signature_request_list.php\n```\n\n## Authentication\nAccess tokens automatically initialize when they’re successfully retrieved from the given user's credentials (after PDFfiller\\OAuth2\\Client\\Provider\\PDFfiller::getAccessToken($grant_type, $options) method), according to the example below:\n````php\n\u003c?php\nrequire_once __DIR__.'/vendor/autoload.php';\n\nuse \\PDFfiller\\OAuth2\\Client\\Provider\\Enums\\GrantType;\nuse \\PDFfiller\\OAuth2\\Client\\Provider\\PDFfiller;\n\n$oauthParams = [\n    'clientId'       =\u003e 'YOUR_CLIENT_ID',\n    'clientSecret'   =\u003e 'YOUR_CLIENT_SECRET',\n    'urlAccessToken' =\u003e 'https://api.pdffiller.com/v2/oauth/token',\n    'urlApiDomain'   =\u003e 'https://api.pdffiller.com/v2/'\n];\n\n$passwordGrantCredentials = [\n    'username' =\u003e 'pdffiller_account@example.com',\n    'password' =\u003e 'some_pass'\n];\n\n/** @var \\PDFfiller\\OAuth2\\Client\\Provider\\PDFfiller $provider */\n$provider = new PDFfiller($oauthParams);\n\n$accessToken = $provider-\u003egetAccessToken(GrantType::PASSWORD_GRANT, $passwordGrantCredentials);\nprint_r($accessToken);\n````\n\nWhen your authorization has been completed successfully you can use the provider for retrieving, creating, updating or deleting information from your profile.\n\n## Usage\n\nUse a static method to retrieve a list of all applications:\n`PDFfiller\\OAuth2\\Client\\Provider\\Core\\Model::all(PDFfiller $provider)`\n````php\n$list = Application::all($provider);\nprint_r($list);\n````\nFor retrieving information about one application, call static: \n`PDFfiller\\OAuth2\\Client\\Provider\\Core\\Model::one(PDFfiller $provider, $appClientId)`\n````php\n$application = Application::one($provider, 'app_client_id');\nprint_r($application);\n````\n\nIf you want to create a new application, you must create a new Application object with the necessary information and save it using the following method:\n`PDFfiller\\OAuth2\\Client\\Provider\\Core\\Model::save()`\n````php\n$application = new Application($provider);\n\n$application-\u003ename = 'App name';\n$application-\u003edescription = 'Some application description';\n$application-\u003edomain = 'http://some.domain.com';\nprint_r($application-\u003esave());\n````\nIf you want to update an instance, you must retrieve an Application object and save it by using the following method:\n`PDFfiller\\OAuth2\\Client\\Provider\\Core\\Model::save()`\n\n````php\n$application = Application::one($provider, 'app_client_id');\n\n$application-\u003ename = 'Updated App name';\n$application-\u003edescription = 'Some changed application description';\n$result = $application-\u003esave();\nprint_r($result);\n````\nUpdating information is easy by using:\n`PDFfiller\\OAuth2\\Client\\Provider\\Core\\Model::save()` method.\nIf you wish to remove an application, use:\n`PDFfiller\\OAuth2\\Client\\Provider\\Core\\Model::remove()` method\n````php\n$application = Application::one($provider, 'app_client_id');\n$result = $application-\u003eremove();\nprint_r($result);\n````\nAll examples with other endpoints are available in the [examples](https://github.com/pdffiller/pdffiller-php-api-client/tree/master/examples) folder\n\n## Support\nIf you have any problems feel free to contact us:\n* On our issues page https://github.com/pdffiller/pdffiller-php-api-client/issues\n* Via chat or phone at our tech site http://developers.pdffiller.com\n* Join our Gitter chat room for technical advice https://gitter.im/pdffiller/pdffiller-php-api-client\n\n## License\nThis software is licensed under the following MIT [license](https://github.com/pdffiller/pdffiller-php-api-client/blob/3.0.0/LICENSE)\n\n## Author\nAPI Team (integrations@pdffiller.com)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpdffiller%2Fpdffiller-php-api-client","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpdffiller%2Fpdffiller-php-api-client","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpdffiller%2Fpdffiller-php-api-client/lists"}