Make `api/v2/data/challenge` public

[tordans]

I am looking for a way to display the detailed progress of a challenge on my campaign website.

The best API I found to get the data that is used on the challenge dashboard in MR is https://maproulette.org/api/v2/data/challenge/ID

Question: Is this true or is there a different API that I can use?

There are two issues with the /data/challenge/ID API:

---

Issue 1: It is private and requires an apiKey to work.
This is very unfortunate, because it means I have to build workarounds to get this data to show it in a public environment. We cannot just use our MapRoulette API Key in a public JavaScript app, though, so we need to build a proxy on some server – which is what I did for now.

The API, however, does not expose any personal or sensitive data, its just numbers.

==> Please make this API endpoint public (no apiKey required)

This is the data that the Endpoint returns:

z.array(
  z.strictObject({
    id: z.number(),
    name: z.string(),
    actions: z.object({
      total: z.number(),
      available: z.number(),
      fixed: z.number(),
      falsePositive: z.number(),
      skipped: z.number(),
      deleted: z.number(),
      alreadyFixed: z.number(),
      tooHard: z.number(),
      answered: z.number(),
      validated: z.number(),
      disabled: z.number(),
      avgTimeSpent: z.number(),
      tasksWithTime: z.number(),
    }),
  }),
)

---

Issue 2: Missing documentation
I was not able to find any documentation of this API endpoint at https://maproulette.org/docs/swagger-ui/index.html#/Follow

==> Please add it to the docs, so its easier to find

[CollinBeczak]

Talked with @ljdelight, the data endpoints were updated to require auth to avoid outages because they're very slow. We'd need to look into fixing that issue before removing auth, but i should be able to get the swagger-docs updated in the near future.

[tordans]

@CollinBeczak do you know of a different, more performant way to retrieve the progress data? A simple "total vs. completed" would be enough for me.

ATM I run into the issue that the data API returns no data in too many cases, probably timeouts.

I see that there are properties like

    "completionPercentage": 0,
    "tasksRemaining": 262,

on the https://maproulette.org/api/v2/challenge/50884 response, but the total is missing. And both values are stale (or not what I expect them to be), because numbers should be 193 total and 1%.

[CollinBeczak]

I should be looking more into the efficiency of endpoints soon. And hoping to also limit some of the stale data more... You can probably use this endpoint:
https://maproulette.org/api/v2/data/challenge/50884

[{"id":50884,"name":"Name","actions":{"total":193,"available":192,"fixed":1,"falsePositive":0,"skipped":0,"deleted":0,"alreadyFixed":0,"tooHard":0,"answered":0,"validated":0,"disabled":0,"avgTimeSpent":14000,"tasksWithTime":1}}]

Total = Total
Completed = total - available or total - (fixed + falsePositive)

[mvexel]

broke out docs request into a separate ticket (in docs repo)

[mvexel]

@jake-low any chance you could look into this?