# FAQ

This page answers common questions about VirtualCar360, Player, Player 360, video, certificates and API integration.

## General

### What is VirtualCar360?

VirtualCar360 is a solution for presenting vehicles online using photos, 360° galleries, interactive Players, hotspots, video materials, certificates and API integrations.

### What is the difference between the Player and the API?

The Player is a ready-made component embedded as an `iframe`. The API is used to retrieve data such as galleries, photos, hotspots and video links for custom implementations.

### When should I use the Player?

Use the Player when you want to quickly embed a complete vehicle presentation without building a custom gallery.

### When should I use Player 360?

Use Player 360 when you want to present a smooth interactive 360° rotation of a vehicle.

### When should I use the API?

Use the API when you want to build your own gallery, import data into another system, archive photos or integrate with CRM, DMS or a classified portal.

## Access and authorization

### How do I get an API key?

Contact VirtualCar360 support. The key can be assigned to one location or multiple locations as a group key.

### Is the API key required?

Yes. API calls require the `key` query parameter. Player URLs also require a key when they retrieve data from VirtualCar360.

### Can one key work for multiple locations?

Yes. A group key can be configured by support for multi-location or multi-brand organizations.

## Player

### How do I embed the Player?

```html
<iframe
  src="https://virtualcar360.pl/player/?vin=WBA1234567890&key=YOUR_API_KEY"
  width="100%"
  height="600"
  frameborder="0"
  allowfullscreen
></iframe>
```

### Does the Player require a backend?

No. For simple embedding, the Player can be used directly as an iframe.

### Can the Player load by VIN?

Yes. Use the `vin` parameter.

### Can the Player load by registration number?

Yes. Use the `numberplates` parameter.

### Can the Player load by `carId`?

Yes. `carId` points to a specific Player presentation.

### Does the Player support hotspots?

Yes, if hotspots are available for the gallery.

### Can the Player show certificates?

Yes, if a certificate is available and configured for the vehicle.

## Player 360

### What is Player 360?

Player 360 is a Player variant for smooth interactive vehicle rotation.

### How many frames does Player 360 use?

Depending on configuration, Player 360 can use 180 or 360 frames.

### Are all frames real photos?

No. Intermediate frames can be generated by AI from 4 or 8 original vehicle shots.

### Do AI-generated frames have hotspots?

No. Hotspots can be available only on original photos.

### How does zoom work?

When zooming, the Player moves to the nearest original photo and zooms into that source image.

## Video

### Is video available by default?

Not always. Contact support to enable video generation.

### What does the default video show?

It shows a 360° vehicle rotation, usually around 20 seconds long, generated from 4 or 8 photos.

### Where is video stored?

In VirtualCar360 and on Vimeo. On request, it can also be uploaded to the customer's YouTube channel.

## Certificate

### Can certificates be retrieved by VIN?

Yes. The Certificate API retrieves certificates by VIN.

### What does the Certificate API return?

It returns URLs for `widget`, `onepage` and available `pdf` files.

### Can I embed a certificate in iframe?

Yes. Use the `widget` URL for embedding.

## Troubleshooting

### The Player does not show a gallery. What should I check?

Check the API key, vehicle identifier, location access and whether the vehicle has a gallery.

### The API returns `404`. What does it mean?

Usually no data was found for the provided VIN, registration number or `carId`.

### Video is missing. Why?

Video may not be enabled, may not have been generated yet or YouTube integration may not be configured.

### Certificate PDF link does not work. Why?

The PDF URL may be temporary. Fetch a fresh certificate response from the API.