Data Importer doesn't show helpful error when authenticating against Spectre with an App type API key

[PolygonError]

Support guidelines

• I've read the support guidelines

I've found a bug and checked that ...

• ... the documentation does not mention anything about my problem
• ... there are no open or closed issues that are related to my problem
• ... it's definitely a Firefly III issue, not me

Description

When attempting to setup the Data Importer to authenticate against Spectre with my API key I was greated with 'Impossible flow exception.' 500 Error.
The logs show that this is caused by Spectre not supporting an endpoint with App API tokens, as shown in this log snippet

[2024-01-13 22:07:31] local.DEBUG: Now in AuthenticateController, calling middleware.
[2024-01-13 22:07:31] local.DEBUG: isReadyForSpectreStep("authenticate")
[2024-01-13 22:07:31] local.DEBUG: Now at App\Services\Spectre\AuthenticationValidator::validate
[2024-01-13 22:07:31] local.DEBUG: setParameters
[2024-01-13 22:07:32] local.ERROR: TransferException: Client error: `GET https://www.saltedge.com/api/v5/customers` resulted in a `400 Bad Request` response:
{"error":{"class":"AppsRestricted","message":"Not available for apps.","documentation_url":"https://docs.saltedge.com/ac (truncated...)

[2024-01-13 22:07:32] local.ERROR: Transfer exception leads to error.

This API key type is not mentioned in the docs when setting up a Salt Edge account.

Debug information

Debug information generated at 2024-01-13 22:12:56 Australia/Brisbane for Firefly III Data Importer version 1.4.0.

System information
Item	Value
Version	1.4.0
Build	#, base #67
System	PHP 8.3.0, Linux, apache2handler

App information
Item	Value
Timezone	Australia/Brisbane, Australia/Brisbane
Environment	local
Debug mode	false, cache 'file'
Log level	debug, stack
Display errors	Off, ALL errors
BCscale	12
Trusted proxies	**

User information
Item	Value
User agent	Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:122.0) Gecko/20100101 Firefox/122.0

Expected behaviour

The importer should notify the user that a Service API key is required for the Spectre data importer.

Steps to reproduce

1. Go to the Firefly III Universal Data Import Tool front page after authenticating against Firefly III
2. Press 'Import from Spectre'
3. Put in a Spectre App ID and secret that are setup as an App API key on saltedge.com

Additional info

No response

[JC5]

You're the first one I know of who did this, but I'll pick it up and see if I can give an proper message about this exception 👍

[github-actions]

Hi there! This is an automatic reply. Share and enjoy

This issue has been marked as an enhancement. The requested enhancement to an existing feature will become a part of Firefly III or the data importer in due course.

If you come across this issue, please be aware there is NO need to reply with "+1" or "me too" or "I need this too" or whatever. Such comments are not helpful, and do not influence the roadmap. Your comment may be 💀 deleted. You can subscribe to this issue to get updates.

Thank you for your contributions.