Help

API Submission

curl example


curl -H "Authorization: token 64BYTELONGUNIQUEAPIKEY"  \
        -F 'issue_type=FP' \
        -F 'sid=2000001' \
        -F 'comments=Please explain the issue here' \
        -F 'files=@/home/yourname/data/new.pcap' \
        -XPOST https://feedback.emergingthreats.net/api

Python example


import requests


def main():
    url = 'https://feedback.emergingthreats.net/api'
    api_key = '64BYTELONGUNIQUEAPIKEY'
    headers = {'Authorization': 'token ' + api_key}
    files = {'files': open('x.pdf', 'rb')}
    payload = {
        'issue_type': 'FP',
        'sid': '2000001',
        'comments':
        'The SID generates a false positive for the attached file.'
    }
    r = requests.post(url, headers=headers, data=payload, files=files)
    print(r.text)


if __name__ == '__main__':
    main()
Where —
Parameter Description Required Valid values
issue_type The type of feedback Yes
FP False Positive
FN False Negative
PERF Performance
COMP Compilation
NEWSIG New signature
NEWREQ New requirement
DESC Description
OTHER Other
sid SID No 2000000-2999999 (from 2M upto 3M)
files submitted files No
  • File attachments are not required, but we encourage you to provide supporting material. This helps us analyze the isue much better.
  • Not more than 5 files (max)
  • Each file cannot be larger than 5MB (max)
comments Comments about the submission. Yes Minimum Length: 20 characters. Maximum length: 400 characters.