Certification Process
Adapter certification ensures your integration meets SpaceOS quality, reliability, and security standards.
Certification Steps
- Build — Implement all required protocol endpoints
- Self-test — Run the certification test suite against your adapter
- Submit — Provide adapter endpoint, API key, and documentation
- Review — ZenSpace engineering reviews your adapter
- Test — Automated and manual testing against the protocol spec
- Certify — Adapter is approved and listed
What We Test
| Area | Checks |
|---|---|
| Protocol compliance | All 7 endpoints respond correctly |
| Health | /ping responds within timeout |
| Capabilities | /capabilities returns valid schema |
| Actions | All declared actions execute successfully |
| Error handling | Graceful handling of invalid requests |
| Security | API key authentication enforced on all endpoints |
| HMAC | Webhook signatures verified correctly |
| Performance | Response times within acceptable limits |
Requirements
- All 7 endpoints implemented
- API key authentication on every endpoint
- HMAC-SHA256 webhook signatures (if webhook_capable)
- Response times under 5 seconds for all endpoints
- Documented device types and actions
- Error responses follow the protocol format
Next Steps
- Versioning & Migration — Protocol version policy
- Tutorial: Build Your First Adapter — Get started building