# EasyAR CRS (Cloud Recognition Service)

> Cloud image-recognition web service by VisionStar Information Technology (Shanghai) Co., Ltd.
> Manage up to 100,000 image targets per cloud database and recognize them from camera frames in
> ~0.1s. Two channels per image-library instance: a Server-end URL (target management, HTTPS :443)
> and a Client-end URL (image recognition, HTTPS :8443, host shaped like
> <your-domain>-cn1.crs.easyar.com). Data centers: China-Shanghai and US-Silicon Valley.
> Generated by API Evangelist from EasyAR's published documentation (no provider llms.txt exists).

## Documentation

- [CRS API reference](https://www.easyar.com/doc/en/api/cloud/cloud-recognition/apis.html): REST protocol, auth and response envelope
- [Target management guide](https://www.easyar.com/doc/en/develop/cloud-recognition/management.html): regions, checklist, portal vs API management
- [API Key & token guide](https://www.easyar.com/doc/en/develop/apikey-auth.html): API Key/Secret, STS token exchange, signature algorithm
- [Error codes](https://www.easyar.com/doc/en/api/cloud/cloud-recognition/status-code.html): unified {statusCode, result, timestamp} envelope
- [Docs home](https://www.easyar.com/doc/en/)

## API operations

- POST /targets: create image target (base64 JPG/PNG, max 2MB; name, size, meta, active, allowSimilar)
- GET /targets/infos: list targets (pageNum, pageSize <= 100)
- GET /target/<target_id>: get one target
- PUT /target/<target_id>: modify target attributes
- DELETE /target/<target_id>: delete target
- POST /grade/detection | /grade/tracking | /grade/detail: image recognizability rating (0-4, -1 invalid)
- POST /similar: check for similar targets before creating
- POST /v2/search: recognize an image (multipart/form-data, Client-end URL :8443)
- GET /ping: health check (no auth)

## Authentication

- Token auth: Authorization header carries an STS-issued temporary token (create via developer center or by signing apiKey+expires+acl+timestamp with the API Secret against https://uac.easyar.com/token/v2)
- Signature auth: appId, timestamp, apiKey, signature request parameters (hex sha256 of sorted key+value pairs + API Secret)
- Never embed API Key/Secret in client apps; generate tokens server-side

## Pricing

- [Pricing](https://www.easyar.com/price.html): 15-day free trial (500 API calls/day), $89/mo (10,000 calls/day), $178/mo (20,000 calls/day), overage $0.01/call

## Support

- [Support](https://www.easyar.com/view/support.html)
- [Developer sign-up](https://www.easyar.com/view/signup.html)
- Contact: support@easyar.com