fix total_count

[csillag]

SUMMARY

When returning pagination results, one of the data fields is total_count. It's not behaving as it should.

It's defined here:

    total_count:
      type: integer
      format: uint64
      description: |
        The total number of records that match the query, i.e. the number of records
        the query would return with limit=infinity.

However, the returned value changes based on the offset we pass to the quest.

ISSUE TYPE

• Bug Report

STEPS TO REPRODUCE

Compare this nd this.

ACTUAL RESULTS

In the first case, the offset we pass is 0, and the returned total_count is 53.
In the second case, offset is 30, and the returned total_count is 23.

EXPECTED RESULTS

On a higher level, the returned total_count should be (as the name suggests) total, so it shouldn't depend on the offset we are asking.

In practice, total_count should be increased by the value of the passed offset.

Alternatively, let's rename total_count field to remaining_results, and update the documentation accordingly.