A Github Action to wait for a specific API response to proceed.

This can be useful to wait e.g. for a specific version of an API to deployed or similar.

uses: mydea/action-wait-for-api@v1
with:
  url: "https://api.example.com/status"
  expected-response-field: "version"
  expected-response-field-value: ${{env.EXPECTED_API_VERSION}}

Required The full URL to query.

Required The HTTP method to use. Default "GET".

Optional JSON-string of headers to send along. For example:

headers: '{"Authorization":"ci"}'

Required The HTTP status which has to be returned to continue. Default "200".

If set, only continue if the response contains this field. You can use dot-notation to query nested fields, for example:

{
  "user": {
    "name": "Anne"
  }
}

Can be queried with "user.name".

If set, the expected-response-field must contain this value to continue. Note that due to Github Action restrictions, this can only work with strings, so any value is converted to a string.

Required The max. amount of seconds to wait until to stop trying to reach the API. Default "300".

Required The number of seconds to wait between each try to the API. Default "10".