Endpoints and Contracts
You access the contract-based REST API through endpoints that you configure on the Web Service Endpoints (SM207060) form.
Endpoints and Contracts
An endpoint is an entry point to the MYOB Acumatica web services. For each endpoint that the REST API provides, a contract of the endpoint defines the entities, along with their actions and fields, that are available through the endpoint and the methods that you can use to work with these entities.
The endpoint is identified by the URL that you use to access the web services API. You can see
the name and version of an endpoint in its URL. For example, the endpoint
http://localhost/AcumaticaDB/entity/Default/23.200.001
has the version
23.200.001 and the name Default. The version of an endpoint defines the list of
entities, with their actions and fields you can work with through this endpoint.
System and Custom Endpoints
You can use two types of endpoints to access the web services:
-
System endpoint: The system endpoints are precofigured in the system and have the Default name. Each of these endpoints has a predefined contract, which includes the API that is preconfigured in the system. You cannot change the contract of a system endpoint.
If the API that is available in the contract of a system endpoint is sufficient for the requirements of your application, you should use the system endpoint for accessing MYOB Acumatica web services. You can use the same system endpoint in future versions of MYOB Acumatica. For example, if you use the system endpoint with Version 22.200.001 and Contract Version 4 to access MYOB Acumatica 2022 R2, you can use the same endpoint to access future versions of MYOB Acumatica.
Note: MYOB Acumatica can include endpoints preconfigured in the system that have names other than Default. The system uses these endpoints internally. We recommend that you not use these endpoints. -
Custom endpoint: By default, there are no custom endpoints in the system. If the API provided by the system endpoint is not sufficient for the requirements of your application, you can create a custom endpoint. You can configure the contract of a custom endpoint by adding the needed elements of the API to the contract.
If you need to use the same custom endpoint in future versions of MYOB Acumatica, you should maintain it in future versions.