{"id":37440611,"url":"https://github.com/holodeck-b2b/rest-backend","last_synced_at":"2026-01-16T06:44:28.457Z","repository":{"id":44161598,"uuid":"190747174","full_name":"holodeck-b2b/rest-backend","owner":"holodeck-b2b","description":"An extension for Holodeck B2B that implements the Submit, Notify and Deliver operations using a REST API.","archived":false,"fork":false,"pushed_at":"2025-12-29T13:11:22.000Z","size":278,"stargazers_count":6,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2026-01-01T15:13:03.725Z","etag":null,"topics":["backend-api","connector","extension","holodeckb2b","rest","rest-api"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/holodeck-b2b.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.MD","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2019-06-07T13:23:29.000Z","updated_at":"2025-12-29T13:11:18.000Z","dependencies_parsed_at":"2024-02-22T10:43:00.534Z","dependency_job_id":null,"html_url":"https://github.com/holodeck-b2b/rest-backend","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/holodeck-b2b/rest-backend","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/holodeck-b2b%2Frest-backend","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/holodeck-b2b%2Frest-backend/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/holodeck-b2b%2Frest-backend/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/holodeck-b2b%2Frest-backend/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/holodeck-b2b","download_url":"https://codeload.github.com/holodeck-b2b/rest-backend/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/holodeck-b2b%2Frest-backend/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28477934,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-16T06:30:42.265Z","status":"ssl_error","status_checked_at":"2026-01-16T06:30:16.248Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["backend-api","connector","extension","holodeckb2b","rest","rest-api"],"created_at":"2026-01-16T06:44:27.880Z","updated_at":"2026-01-16T06:44:28.414Z","avatar_url":"https://github.com/holodeck-b2b.png","language":"Java","readme":"# Holodeck B2B REST back-end integration\nAn extension for Holodeck B2B that implements the _Submit_, _Notify_ and _Deliver_ operations using a REST API. The message meta-data are included in the HTTP headers and the payload of _User Messages_ as entity body. For simplicity and as it is a very common use-case this implementation only supports _User Messages_ with a single payload.\n\n__________________\nFor more information on using Holodeck B2B visit http://holodeck-b2b.org  \nLead developer: Sander Fieten  \nCode hosted at https://github.com/holodeck-b2b/rest-backend  \nIssue tracker https://github.com/holodeck-b2b/rest-backend/issues  \n\n## Installation\n### Prerequisites  \nThis extension requires that you have already deployed Holodeck B2B version 6.0.0 or later and the [*\"rest-no-error-content\"* Axis2 module](https://github.com/holodeck-b2b/axis2-rest-status-only-error).\n\n### Installation and Configuration\nFirst step is to build the extension or download the latest release. You should now have the `rest-backend-«version».jar` and `hb2b-rest-backend.aar` files available. Copy the jar file to the `lib` directory of the Holodeck B2B instance and copy the aar file to the `repository/services` directory to enable the REST interface in the Holodeck B2B instance. Please note that you cannot activate the extension in a running Holodeck B2B instance and will need to restart the server to activate the REST extension.\n\nNo additional configuration is needed for the _Submit_ operation. The _Delivery_ and _Notify_ operations are configured in the\nP-Modes by setting the _delivery method_. To use this REST back-end integration set the applicable `DeliveryMethod` element to `org.holodeckb2b.backend.rest.NotifyAndDeliverOperation` and configure its parameters:\n1. _URL_ : the URL where the REST service is hosted by the back-end application. As explained above \"/deliver\" will be added\n to this URL when delivering _User Messages_ and for \"/notify/receipt\" and \"/notify/error\" for notification of _Receipt_ respectively _Error_ Signals.\n2. _TIMEOUT_ : the time (in milliseconds) the delivery method should wait for the back-end system to accept the delivery and notification. This parameter is optional and when not specified a default timeout of 10 seconds will be used.\n3. _SIGNAL_WITH_CONVID_ : indicates whether the \u003ci\u003eConversationId\u003c/i\u003e of the User Message referenced by the notified Signal Message should be included in the notification to the back-end system. This is an optional parameter and when not specified the ConversationId will not be included.\n\n## API Specification\nFor a full description how the operations are implemented see the [API Specification page](api_specification.md).\n\n## Contributing\nWe are using the simplified Github workflow to accept modifications which means you should:\n* create an issue related to the problem you want to fix or the function you want to add (good for traceability and cross-reference)\n* fork the repository\n* create a branch (optionally with the reference to the issue in the name)\n* write your code\n* commit incrementally with readable and detailed commit messages\n* submit a pull-request against the master branch of this repository\n\nIf your contribution is more than a patch, please contact us beforehand to discuss which branch you can best submit the pull request to.\n\n### Submitting bugs\nYou can report issues directly on the [project Issue Tracker](https://github.com/holodeck-b2b/rest-backend/issues).  \nPlease document the steps to reproduce your problem in as much detail as you can (if needed and possible include screenshots).\n\n## Versioning\nVersion numbering follows the [Semantic versioning](http://semver.org/) approach.\n\n## License\nThis module is licensed under the General Public License V3 (GPLv3) which is included in the LICENSE in the root of the project.  \n**NOTE** that this license only applies to the source code contained in this project and **does not apply to** the implementation of the REST API by **the backend system**.\n\n## Support\nCommercial Holodeck B2B support is provided by Chasquis. Visit [Chasquis-Consulting.com](http://chasquis-consulting.com/holodeck-b2b-support/) for more information.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fholodeck-b2b%2Frest-backend","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fholodeck-b2b%2Frest-backend","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fholodeck-b2b%2Frest-backend/lists"}