API reference

Darvis\Snelstart\Services\SnelstartAPI

The constructor reads the config and throws a SnelstartException when the token URL or the client key is empty. Every method that makes a request returns an array and throws a SnelstartException on a 4xx or 5xx, see How it works.

Method	Request
`getCompanyInfo(): array`	`GET /companyInfo`
`getRelaties(array $query = []): array`	`GET /relaties`
`createRelatie(array $data): array`	`POST /relaties`
`getArtikelen(array $query = []): array`	`GET /artikelen`
`createVerkooporder(array $data): array`	`POST /verkooporders`
`get(string $uri, array $query = []): array`	`GET` with a query string
`post(string $uri, array $data = []): array`	`POST` with a JSON body
`put(string $uri, array $data = []): array`	`PUT` with a JSON body
`delete(string $uri, array $query = []): array`	`DELETE` with a query string
`head(string $uri, array $query = []): array`	`HEAD` with a query string, always returns `[]`
`forgetToken(): void`	No request: drops the access token, in memory and in the cache

$uri is relative to the base URL, with or without a leading slash.
An empty $data array sends no body at all.

The class is not final. The protected members request(), sendRequest(), getAccessToken(), handleError(), redactSecrets() and the properties $baseUrl, $tokenUrl, $clientKey, $subscriptionKey, $timeout, $connectTimeout, $accessToken and $tokenExpiresAt are there for a subclass.

Darvis\Snelstart\Services\EchoService

Calls the /echo/resource endpoint through the client, to see that a request makes the round trip. It never throws.

Method	Request	Without arguments it sends
`getEchoResource(array $params = []): array`	`GET /echo/resource`	`param1=sample`
`headEchoResource(array $params = []): array`	`HEAD /echo/resource`	`param1=sample`
`postEchoResource(array $data = []): array`	`POST /echo/resource`	a sample vehicle (`vehicleType`, `maxSpeed`, `avgSpeed`, `speedUnit`)

On success:

[
    'success' => true,
    'message' => 'Echo resource GET successful',
    'response_time_ms' => 182.41,
    'timestamp' => '2026-09-21T10:00:00.000000Z',
    'query_params' => ['param1' => 'sample'],   // 'request_data' for the POST
    'response' => [...],
]

On a failure:

[
    'success' => false,
    'message' => 'Echo resource GET failed',
    'error' => 'Snelstart API call failed. HTTP status: 401. ...',
    'error_code' => 401,
    'timestamp' => '2026-09-21T10:00:00.000000Z',
]

error_code is the code of the exception: the HTTP status for a call SnelStart answered with a 4xx or 5xx, and 0 when there was no response, such as a timeout. Up to 1.2 it was always 0.

Darvis\Snelstart\Standalone\SnelstartAPI

The same ten methods and forgetToken() (memory only, it has no cache), plus:

Method	What it does
`__construct(array $config)`	Keys `base_url`, `token_url`, `client_key`, `subscription_key`, `timeout` and `connect_timeout`. The URLs fall back to the SnelStart URLs, the timeouts to 30 and 10 seconds.
`fromEnv(): self`	Reads `SNELSTART_BASE_URL`, `SNELSTART_TOKEN_URL`, `SNELSTART_CLIENT_KEY`, `SNELSTART_SUBSCRIPTION_KEY`, `SNELSTART_TIMEOUT` and `SNELSTART_CONNECT_TIMEOUT` with `getenv()`.

See Standalone client.

Darvis\Snelstart\Exceptions\SnelstartException

What both clients throw. It extends RuntimeException and has the message the plain RuntimeException had up to 1.2.

Method	Returns
`status(): int`	The HTTP status of the response that caused the exception, or `0` when there was no response
`getCode()`	The same number
`getMessage()`	`Snelstart API call failed. HTTP status: 429. Response: ...` and the other messages, with the keys redacted

Thrown for	`status()`
A 4xx or 5xx of the API, also the second 401 after the repeat	that status
A 4xx or 5xx of the token endpoint	that status
A 2xx token response without `access_token`	the status of that response
An incomplete config	`0`
A cURL error in the standalone client (timeout, DNS, refused connection)	`0`

The response body is not available as a property. The Laravel client lets Illuminate\Http\Client\ConnectionException through unchanged; that is not a SnelstartException.

Darvis\Snelstart\Support\SnelstartConfig

Method	Returns
`baseUrl(): string`	`snelstart.base_url` without a trailing slash, default `https://b2bapi.snelstart.nl/v2`
`clientKey(): string`	`snelstart.client_key`, or an empty string
`connectTimeout(): float`	`snelstart.connect_timeout` in seconds, `10.0` when it is not a positive number
`subscriptionKey(): ?string`	`snelstart.subscription_key`, or `null` when it is empty
`timeout(): float`	`snelstart.timeout` in seconds, `30.0` when it is not a positive number
`tokenCacheEnabled(): bool`	`snelstart.token_cache.enabled`, `true` unless it is a no (`false`, `0`, `off`, `no`)
`tokenCacheStore(): ?string`	`snelstart.token_cache.store`, or `null` for the default cache store
`tokenUrl(): string`	`snelstart.token_url`, default `https://auth.snelstart.nl/b2b/token`

Container bindings

Abstract	Alias	Lifetime
`Darvis\Snelstart\Services\SnelstartAPI`	`snelstart`	singleton
`Darvis\Snelstart\Services\EchoService`	`snelstart.echo`	singleton

The client is built the first time it is resolved, so an application without keys boots normally and only fails where it uses the client. The package has no facade.

Artisan

Command	What it does
`php artisan snelstart:test`	Fetches `/companyInfo`, prints the result as JSON, exits with 0 or 1

Publish tags

Tag	Publishes
`snelstart-config`	`config/snelstart.php`