Bitrise.io API v0.1 (Work In Progress)

[cg1]

@viktorbenei Am I missing something or is the documentation on https://devcenter.bitrise.io/api/v0.1/ very incomplete and half-hearted at the moment? What I mean is this:

POST /apps/register ⚓

Add a new application
Example curl request ⚓

curl -H 'Authorization: token THE-ACCESS-TOKEN' 'https://api.bitrise.io/v0.1/apps/APP-SLUG' -d '{"provider":"github","is_public":false,"repo_url":"git@github.com:api_demo/example-repository.git","type":"git","git_repo_slug":"example-repository","git_owner":"api_demo"}'

Example response ⚓

{
  "status": "ok",
  "slug": "022d8a3124f1225d"
}

This is all information there is for the “new app” API endpoint. The data I need to send is totally undocumented, there’s only an example. What I’m missing at least:

• [ ] A short description for each request parameter.
• [ ] All possible values for enum cases.

For example, I have no idea how to setup a new project which is hosted on a self-hosted GitLab server. What’s the right value for provider? What’s the git_owner? And on registering webhook, the example doesn’t even include any sent data – how does it work, then? I have do find these things out through trial and error now.

Also it’s totally unclear to me how the entire app creation process works given there are separate API endpoints for register-ssh-key, register-webhook and app/APP-SLUG/finish … will I have to wait and check some status until the scanner has completed? What if the scanner finds errors, how do I get them?

A complete documentation for the currently existing APIs would be very helpful!

[cg1]

I have done some digging by now and managed to find out some stuff. When I try to finish the creation process though, I get an internal server error. Specifically this is what I’m sending:

Request to 'https://api.bitrise.io/v0.1/apps/<SOME-SLUG>/finish' failed.
Request body:
{"project_type":"ios","envs":{},"organization_slug":"<SOME-SLUG>","mode":"manual","stack_id":"osx-xcode-edge"}

The response is this:

{"status":500,"error":"Internal Server Error"}

Since it’s a 500 status code, there must be an issue on the backend side…

[viktorbenei]

@gergelybekesi any suggestion?

[ghislainfrs]

Hi @viktorbenei!
It seems there is a new status for builds (status 4, “abordted-with-success”), right? Any reason why it does not appear on the documentation?
Unfortunately this makes my iOS app crash

[viktorbenei]

Indeed we introduced that a while ago and missed to add it to the docs, sorry @ghislainfrs - I’ll create a card for the docs team to update it!

[rishabhclassplus]

Can anyone provide me a way to assign the path of my profile and certificate which is already in my cloned code to bitrise.(using git)
right now, i am giving
{“mapped_to”:"$BITRISE_PROVISION_URL",“value”:“file://./profile/bitdist.mobileprovision | file://./profile/bitdev.mobileprovision”,“is_expand”:true}
but it is not working…

[gergelybekesi]

Hey @jamitlabs

Sorry for the late response, I’ve updated the documentation on DevCenter, there was an issue in the description and also I’ve added some more details Here you can find the documentation for the finish endpoint, the issue was that the description mentioned config_id field in the request body, however it has to be called config. Sorry for the inconvenience!

[jessyhanzo]

Hi @viktorbenei, have you got more info about « Trigger Build » ? Indeed there is a solved FR which seems to be related or maybe I misunderstand something… Was there any rollback ? Thanks.

Allow build to be started / triggered with Personal Access Token

Description of the feature request With the current api, we can have the list of application with each slug. In order to start a build, we also need the application token, which can be found only in code section. Use case / for what or how I would use it I am currently developing an Android App, and if I want to start a new build from the api, with the information the api can give me.

[bitce]

Hi @jessyhanzo what’s the issue you’re facing exactly? Don’t forget you can contact us on our on-site chat anytime!

[Testablekarma]

Hey - just following on as I feel like I’m seeing the same issue regarding your build trigger docs.

Within that you don’t mention how to trigger a build just using Personal Access Token which was discussed and apparently implemented here:

Allow build to be started / triggered with Personal Access Token

Description of the feature request With the current api, we can have the list of application with each slug. In order to start a build, we also need the application token, which can be found only in code section. Use case / for what or how I would use it I am currently developing an Android App, and if I want to start a new build from the api, with the information the api can give me.

Just wondering if this was still the case & something got missed from the trigger docs or whether that’s changed?

[ramonornela]

@gergelybekesi is the documentation (swagger) update?

[igor.asharenkov]

Is this is what you are looking for?

bitrise-io/devcenter/blob/b39cdf0677707bf65271b845bf7ae48113d210e9/_articles/api/v0.1.md#post-appsapp-slugbuilds

" POST /apps/{APP-SLUG}/builds Trigger a new build."

This is still missing in swagger docs but API works.

[Testablekarma]

It looks like it - just to confirm that this does or doesn’t required the build_token? I’m trying to create something which can start a new build just from what I get from the API rather than users having to trundle through the web interface if that’s at all possible.

Could very well be my misunderstanding from that other link I posted

[igor.asharenkov]

Doesn’t require build token, only your API access key. I use it in my desktop client (https://github.com/deszip/BitBot) and it works just fine.

[Testablekarma]

That’s exactly it then, thanks!

[gustavo.soares]

Guys! Could you help me with the register-ssh-key endpoint?
For every time the request was sent, I receive:
{
“error_msg”: “Failed to register SSH key for service: bitbucket. Try to register the Public Key manually on bitbucket.”,
“error_type_code”: 2
}

I checked my bitbucket account, it’s integrated and the ssh keys are generated correctly with key type RSA.

[lopsae]

Please allow bitrise.yml to be sent as a binary using cUrl:

curl -X POST
  -H 'Authorization: token ACCESS-TOKEN'
  https://api.bitrise.io/v0.1/apps/APP-SLUG/bitrise.yml
  --data-binary @bitrise.yml

[YishaiInv]

Not sure if this should be in a new thread somewhere but the API for listing workflows shows even deleted workflows. I guess this could be intentional but perhaps it should be optional.

[sukoh]

Hello, is there any chance there will be an API to query the details of a build?

I know we have this endpoint " /apps/{app-slug}/builds/{build-slug}", but it only gives the data about the workflow, but I’m looking to query data for every individual step as well, like the start and stop time of each step, or the total time a step spent. For example, at the end of each build we can see the “bitrise summary”, which is something we would like to get via API for metrics purposes:

[bitce]

@sukoh Thanks for the #feature-request! We’ll definitely consider this