BC Short Term Registry API - :batchValidate requesting data not in spec

STRR
1

Getting the following error message from Developer API portal using provided test data:

{
    "errorMessage": "API backend third party service error.",
    "rootCause": "errors:[code:INVALID_REQUEST,message:'control' object does not have required attributes.,code:INVALID_REQUEST,message:'permits' object not present in the request.] "
}

As you can see, the batchValidate POST body definition has no such element:

batch_validate_body
batch_validate_body795×852 33.1 KB

Can anyone help us interpret this?

2

If I change the data element in the POST body to permits, the error is reduced to

{
    "errorMessage": "API backend third party service error.",
    "rootCause": "errors:[code:INVALID_REQUEST,message:'control' object does not have required attributes.] "
}

However, the control element contains all required elements specified in the API docs:

  "control": {
    "count": 2,
    "callBackUrl": "http://example.com/callbacks/bcstr?token=e1231nk123bni12uhi1ub4k2jb3hi2ughri23br"
  },
3

I have re-posted this in STRR. Please go to BC Short Term Registry API - /permits/:batchValidate requesting data not in API spec

4

Hi Taivo, I have asked our Technical Architect to provide an answer to your question as soon as I get it I will post it.

Thank you for your patience

5

HI Taivo,

Thanks for your continued engagement and questions.

From our Technical Architect

To clarify, the SPEC has already been released. It was shared ahead of the Sandbox at the request of the Platforms team, who required early access to support their planning.

We’ll share an announcement as soon as the Sandbox is ready for use.

Please let me know if you require further clarification

6

We do need further clarification, thanks.

Is “The SPEC” your reference the yaml RELEASE CANDIDATE doc with dated 2025-03-15 that we get from clicking “Download the Specification”, here: Short-Term Rental Registry API (Platform) - Overview | Service BC Connect Developer Site

info:
  title: BC Short Term Rental Registry Validation API
  version: '0.7'

We were directed to follow these Account Setup directions: Get Started - Account Setup | Service BC Connect Developer Site

We have set up our Service BC account, gotten our API Sandbox key, and are trying to access the validation endpoints outlined in that doc.

Are you saying that the Sandbox is currently unusable for testing? And that all we can do so far is to code off of the API Version 0.7 2025-03-15 Release Candidate doc?

I feel like I must be misinterpretating what you’re saying, as we have provincial requirements to start validations May 1st, about 5 weeks away.

If this is the case, when can we expect to test against the sandbox, in order to be able to advance to Step 7 of Account Setup "After completing your testing, email a request for keys to BC Registries Production Environment. "?